Funzione InstallStatusMIFEx

Articolo
04/04/2023

La InstallStatusMIFEx funzione, in Configuration Manager, migliora la funzionalità di InstallStatusMIF.

Sintassi

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

Parametri

pszFileName
Puntatore a un nome univoco per il file MIF (Management Information Format). 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 e limitato a 16 caratteri.

pszSerialNo
Puntatore al numero di serie del prodotto. Questo parametro è facoltativo e limitato a 64 caratteri.

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

bStatus
true se lo stato di installazione è riuscito.

bProgramReboots
true se il programma riavvierà il computer.

Valori restituiti

Valore diverso da zero per indicare l'esito positivo.

Osservazioni

InstallStatusMIFEx è funzionalmente equivalente a InstallStatusMIF, ad eccezione dell'aggiunta del bProgramRebootparametro . L'uso bProgramRebootdi è il modo più affidabile per passare queste informazioni a Configuration Manager, perché durante il riavvio Configuration Manager potrebbe non essere in grado di ottenere il codice di uscita corretto dal processo. Se, dopo aver completato l'esecuzione del programma, il programma imposta questo flag nel file MIF e non è stato eseguito un riavvio, Configuration Manager attende un minuto prima di avviare qualsiasi altro programma. Ciò consente il completamento del riavvio. Questo flag consente anche a Configuration Manager di inviare un messaggio di stato di esito positivo preliminare per il programma e quindi un messaggio di stato finale di esito positivo dopo il riavvio.

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 InstallStatusMIFEx prima che l'installazione venga chiusa. Il file MIF non viene segnalato a Configuration Manager se l'installazione crea un altro processo che chiama InstallStatusMIFEx.

I parametri pszFilename, pszCompany, pszProducte 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.

Requisiti

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

Versione: richiede SMS 2003 Advanced Client.

Libreria: inclusa come risorsa in IsMIF32.dll (C/C++).

Vedere anche

Funzioni MIF di stato
InstallStatusMIF
Classe WMI del server SMS_Package

Condividi tramite