Funzione InstallStatusMIF

Articolo
04/04/2023

La InstallStatusMIF funzione crea un file MIF (Management Information Format) di stato 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. Un'estensione del nome 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 del paese o della lingua, ad esempio ENU. Questo parametro è facoltativo ed è limitato a 16 caratteri.

pszSerialNo
Puntatore al numero di serie 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 di installazione è riuscito.

Valori restituiti

Valore diverso da zero per indicare l'esito positivo.

Osservazioni

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

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

L'applicazione deve chiamare InstallStatusMIF prima che l'installazione venga chiusa. 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, , pszCompanypszProducte pszVersion sono direttamente correlati rispettivamente alle proprietà MIFFileNamedella classe WMI del server SMS_Package , MIFPublisher, MIFNamee 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 illustra come chiamare la InstallStatusMIF funzione usando direttamente il file Ismif32.dll. Un errore durante il 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

Funzioni MIF di stato
Classe WMI del server SMS_Package

Condividi tramite