Função InstallStatusMIFEx

A InstallStatusMIFEx função, no Configuration Manager, melhora a funcionalidade de 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 ficheiro de Formato de Informação de Gestão (MIF). Uma extensão de nome de ficheiro tem de ser .mif. A função escreve o ficheiro no diretório %TEMP%.

pszCompany Ponteiro para o fabricante ou publicador do produto, por exemplo, Microsoft. Este parâmetro está limitado a 64 carateres.

pszProduct Ponteiro para o nome do produto ou programa, por exemplo, Microsoft Office 2000. Este parâmetro está limitado a 64 carateres.

pszVersion Ponteiro para a versão do produto, por exemplo, 8.0a. Este parâmetro está limitado a 64 carateres.

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

pszSerialNo Ponteiro para o número de série do produto. Este parâmetro é opcional e está limitado a 64 carateres.

pszMessagePonteiro para uma mensagem descritiva sobre a status da instalação, que é adicionada ao programa status mensagem. Este parâmetro está limitado a 128 carateres.

bStatus truese a instalação status for bem-sucedida.

bProgramReboots true se o programa reiniciar o computador.

Return Values

Um valor diferente de zero para indicar êxito.

Comentários

InstallStatusMIFEx é funcionalmente equivalente a InstallStatusMIF, exceto para a adição do bProgramRebootparâmetro . Utilizar bProgramRebooté a forma mais fiável de transmitir estas informações para Configuration Manager, porque durante o reinício Configuration Manager poderá não conseguir obter o código de saída correto do processo. Se, após concluir a execução do programa, o programa definir este sinalizador no ficheiro MIF e não tiver ocorrido um reinício, Configuration Manager aguardará um minuto antes de iniciar qualquer outro programa. Isto permite tempo suficiente para que o reinício seja concluído. Este sinalizador também permite que Configuration Manager enviem uma mensagem de status de êxito preliminar para o programa e, em seguida, um êxito final status mensagem após o reinício ter ocorrido.

A sua aplicação de instalação (configuração) tem de criar apenas uma instalação status ficheiro MIF para o pacote. O nome de ficheiro que especificar tem de ser exclusivo.

As instalações executadas em versões localizadas do Configuration Manager têm de especificar valores no formato adequado: formato ANSI para idiomas europeus; DBCS formato para idiomas da Ásia Oriental.

A sua aplicação tem de chamar InstallStatusMIFEx antes de a instalação sair. O ficheiro MIF não é reportado ao Configuration Manager se a instalação criar outro processo que chame InstallStatusMIFEx.

Os parâmetros pszFilename, pszCompany, pszProducte pszVersion estão diretamente relacionados com as propriedades MIFFileNameda Classe WMI de Servidor SMS_Package , MIFPublisher, MIFName, e MIFVersion, respetivamente. Estes parâmetros e propriedades têm de 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ída como um recurso no IsMIF32.dll (C/C++).

Confira também

Estado MIF FunctionsInstallStatusMIFSMS_Package Server WMI Class (Classe WMI de Servidor MIF de Estado)