Funzione InstallStatusMIF

La InstallStatusMIF funzione crea un file MIF (Management Information Format) che Configuration Manager usa per correlare lo stato di installazione di un annuncio pubblicitario.

Sintassi

DWORD InstallStatusMIF(
     char* pszFileName,
     char* pszCompany,
     char* pszProduct,
     char* pszVersion,
     char* pszLocale,
     char* pszSerialNo,
     char* pszMessage,
     BOOL bStatus
);

Parametri

pszFileName Puntatore a un nome univoco per il file MIF. L'estensione di file deve essere .mif. La funzione scrive il file nella directory %TEMP%.

pszCompany Puntatore al produttore o all'editore del prodotto, ad esempio Microsoft. Questo parametro è limitato a 64 caratteri.

pszProduct Puntatore al nome del prodotto o del programma, ad esempio Microsoft Office 2000. Questo parametro è limitato a 64 caratteri.

pszVersion Puntatore alla versione del prodotto, ad esempio 8.0a. Questo parametro è limitato a 64 caratteri.

pszLocale Puntatore al codice paese/area geografica o lingua, ad esempio ENU. Questo parametro è facoltativo ed è limitato a 16 caratteri.

pszSerialNo Puntatore al numero seriale del prodotto. Questo parametro è facoltativo ed è limitato a 64 caratteri.

pszMessage Puntatore a un messaggio descrittivo sullo stato dell'installazione, aggiunto al messaggio di stato del programma. Questo parametro è limitato a 128 caratteri.

bStatus true se lo stato dell'installazione è riuscito.

Valori restituiti

Valore diverso da zero che indica l'esito positivo.

Osservazioni

L'applicazione di installazione (setup) deve creare un solo file MIF di stato di installazione per il pacchetto. Il nome file specificato deve essere univoco.

Le installazioni eseguite in versioni localizzate di Configuration Manager devono specificare i valori nel formato appropriato: formato ANSI per le lingue europee; Formato DBCS per le lingue dell'Asia orientale.

L'applicazione deve chiamare InstallStatusMIF prima dell'uscita dell'installazione. Il file MIF non viene segnalato a Configuration Manager se l'installazione crea un altro processo che chiama InstallStatusMIF.

Si noti che i parametri pszFilename, pszCompany, pszProduct, e pszVersion sono direttamente correlati rispettivamente alle proprietà MIFFileNamedella classe WMI del server SMS_Package , MIFPublisherMIFName, e MIFVersion. Questi parametri e proprietà devono contenere gli stessi valori.

La InstallStatusMIF funzione viene fornita in una versione a 32 bit (Ismif32.dll) e in una versione a 16 bit (Ismif16.dll). La DLL appropriata viene installata nel computer client durante il processo di installazione del client Configuration Manager.

L'esempio nella sezione successiva mostra come chiamare la InstallStatusMIF funzione usando direttamente il file Ismif32.dll. Un errore di caricamento del file Ismif32.dll potrebbe indicare che il sistema non è un client Configuration Manager.

Esempio

[C/C++]
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);

#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)

    HINSTANCE  hinst;
    int  RetCode;

    hinst = LoadLibrary("ismif32.dll");

    InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");

    if (InstallStatusMIF)
    {
        RetCode = InstallStatusMIF("Status",
                                   "Microsoft",
                                   "Microsoft SQL Server 7.0",
                                   "7.00.000",
                                   "ENU",
                                   NULL,
                                   "Installation Successful",
                                   true);
    }
    FreeLibrary(hinst);

Requisiti

Windows NT/2000: richiede Windows NT 4.0 o versione successiva.

Windows 95/98: richiede Windows 95 o versione successiva.

Versione: richiede SMS 2.0.

Libreria: inclusa come risorsa in Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Vedere anche

Stato Funzioni MIFSMS_Package classe WMI del server