Funzione InstallStatusMIFEx

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). 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 e può includere al massimo 16 caratteri.

pszSerialNo Puntatore al numero seriale 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 dell'installazione è riuscito.

bProgramReboots true se il programma riavvierà il computer.

Valori restituiti

Valore diverso da zero che indica l'esito positivo.

Osservazioni

InstallStatusMIFEx è funzionalmente equivalente a InstallStatusMIF, tranne che per l'aggiunta del bProgramRebootparametro. L'uso bProgramRebootè 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, Gestione configurazione attende un minuto prima di avviare qualsiasi altro programma. In questo modo il riavvio può essere completato con sufficiente tempo. Questo flag consente inoltre a Gestione configurazione di inviare un messaggio di stato di esito positivo preliminare per il programma e quindi un messaggio di stato di esito positivo finale dopo il riavvio.

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 InstallStatusMIFEx prima dell'uscita dell'installazione. 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 , MIFNameMIFPublisher, e MIFVersion. Questi parametri e proprietà devono contenere gli stessi valori.

Requisiti

Windows NT/2000: Richiede Windows 2000 o versioni successive.

Versione: Richiede il client avanzato SMS 2003.

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

Vedere anche

Stato Funzioni MIFInstallStatusMIFSMS_Package Server WMI Class