Função InstallStatusMIFEx

A InstallStatusMIFEx função, em Configuration Manager, aprimora a funcionalidade do InstallStatusMIF.

Sintaxe

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

Parâmetros

pszFileName
Ponteiro para um nome exclusivo para o arquivo MIF (Formato de Informações de Gerenciamento). Uma extensão de nome de arquivo deve ser .mif. A função grava o arquivo no diretório %TEMP%.

pszCompany
Ponteiro para o fabricante ou editor do produto, por exemplo, Microsoft. Esse parâmetro é limitado a 64 caracteres.

pszProduct
Ponteiro para o nome do produto ou do programa, por exemplo, Microsoft Office 2000. Esse parâmetro é limitado a 64 caracteres.

pszVersion
Ponteiro para a versão do produto, por exemplo, 8.0a. Esse parâmetro é limitado a 64 caracteres.

pszLocale
Ponteiro para o país/região ou código de idioma, por exemplo, ENU. Esse parâmetro é opcional e limitado a 16 caracteres.

pszSerialNo
Ponteiro para o número de série do produto. Esse parâmetro é opcional e limitado a 64 caracteres.

pszMessage
Ponteiro para uma mensagem descritiva sobre o status da instalação, que é adicionada à mensagem de status do programa. Esse parâmetro é limitado a 128 caracteres.

bStatus
true se o status de instalação for bem-sucedido.

bProgramReboots
true se o programa reinicializar o computador.

Return Values

Um valor não zero para indicar êxito.

Comentários

InstallStatusMIFEx é funcionalmente equivalente a InstallStatusMIF, exceto pela adição do bProgramRebootparâmetro. Usar bProgramRebooté a maneira mais confiável de passar essas informações para Configuration Manager, pois durante a reinicialização Configuration Manager pode não ser capaz de obter o código de saída correto do processo. Se, após concluir a execução do programa, o programa definir esse sinalizador no arquivo MIF e uma reinicialização não tiver acontecido, Configuration Manager aguardar um minuto antes de iniciar qualquer outro programa. Isso permite tempo suficiente para a reinicialização ser concluída. Esse sinalizador também permite que Configuration Manager envie uma mensagem de status de sucesso preliminar para o programa e, em seguida, uma mensagem de status de sucesso final após a reinicialização.

Seu aplicativo de instalação (instalação) deve criar apenas um arquivo MIF de status de instalação para o pacote. O nome do arquivo que você especificar deve ser exclusivo.

As instalações executadas em versões localizadas de Configuration Manager devem especificar valores no formato apropriado: formato ANSI para idiomas europeus; Formato DBCS para idiomas da Ásia Oriental.

Seu aplicativo deve chamar InstallStatusMIFEx antes da saída da instalação. O arquivo MIF não será relatado para Configuration Manager se a instalação criar outro processo que chame InstallStatusMIFEx.

Observe que os parâmetros pszFilename, pszCompany, pszProduct, e pszVersion estão diretamente relacionados às propriedades MIFFileNameda Classe WMI do servidor SMS_Package , MIFPublisher, , MIFNamee MIFVersion, respectivamente. Esses parâmetros e propriedades devem conter os mesmos valores.

Requisitos

Windows NT/2000: requer o Windows 2000 ou posterior.

Versão: requer o cliente avançado sms 2003.

Biblioteca: incluído como um recurso no IsMIF32.dll (C/C++).

Confira também

Funções MIF de status
InstallStatusMIF
Classe WMI do servidor SMS_Package