Função InstallStatusMIFEx

A InstallStatusMIFEx função, no 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 de Formato de Informações de Gerenciamento (MIF). 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 fornecedor do produto, por exemplo, Microsoft. Esse parâmetro é limitado a 64 caracteres.

pszProduct Ponteiro para o nome do produto ou 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 código de país/região ou 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.

pszMessagePonteiro 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 trueSe o status da instalação for Bem-sucedido.

bProgramReboots true Se o programa reinicializar o computador.

Return Values

Um valor diferente de zero para indicar êxito.

Comentários

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

Seu aplicativo de instalação (configuração) deve criar apenas um arquivo MIF de status de instalação para o pacote. O nome de arquivo especificado deve ser exclusivo.

As instalações executadas em versões localizadas do Configuration Manager devem especificar valores no formato apropriado: formato ANSI para idiomas europeus; Formato DBCS para idiomas do Leste Asiático.

Seu aplicativo deve chamar InstallStatusMIFEx antes que a instalação seja encerrada. O arquivo MIF não será relatado ao Configuration Manager se a instalação criar outro processo que chame InstallStatusMIFEx.

Os parâmetros pszFilename, pszCompany, pszProduct, e pszVersion estão diretamente relacionados às propriedades MIFFileNameda classe WMI do SMS_Package Server , 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 SMS 2003 Advanced Client.

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

Confira também

Status Funções MIFInstallStatusMIFSMS_Package Server Classe WMI