Função InstallStatusMIFEx

Artigo
08/12/2021

A InstallStatusMIFEx função, no Gestor de Configurações, 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 único para o ficheiro Formato de Informação de Gestão (MIF). Uma extensão de nome de ficheiro deve ser .mif. A função escreve o ficheiro para o diretório %TEMP% .

pszCompany
Ponter o fabricante ou editor do produto, por exemplo, a Microsoft. Este parâmetro está limitado a 64 caracteres.

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

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

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

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

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

bStatus
true se o estado de instalação for um sucesso.

bProgramReboots
true se o programa reiniciar o computador.

Valores de devolução

Um valor não-zero para indicar sucesso.

Observações

InstallStatusMIFEx é funcionalmente equivalente a InstallStatusMIF , exceto para a adição do bProgramReboot parâmetro. A utilização bProgramReboot é a forma mais fiável de passar esta informação ao Gestor de Configuração, porque durante o reboot o Gestor de Configuração pode não ser capaz de obter o código de saída correto do processo. Se, após completar a execução do programa, o programa definir esta bandeira no ficheiro MIF e não tiver ocorrido um reboot, o Gestor de Configuração aguarda um minuto antes de lançar qualquer outro programa. Isto permite tempo suficiente para o reboot terminar. Esta bandeira também permite que o Gestor de Configuração envie uma mensagem preliminar de estado de sucesso para o programa e, em seguida, uma mensagem de estado de sucesso final após o reboot ter ocorrido.

A aplicação de instalação (configuração) deve criar apenas um ficheiro MIF de estado de instalação para a embalagem. O nome do ficheiro que especifica deve ser único.

As instalações que funcionam em versões localizadas do Gestor de Configuração devem especificar valores no formato apropriado: formato ANSI para línguas europeias; Formato DBCS para línguas da Ásia Oriental.

A sua aplicação deve ser chamada InstallStatusMIFEx antes da saída da instalação. O ficheiro MIF não é comunicado ao Gestor de Configuração se a instalação criar outro processo que ligue InstallStatusMIFEx .

Note que os parâmetros pszFilename , pszCompany , e pszProduct pszVersion estão diretamente relacionados com as propriedades da classe WMI do SMS_Package servidor , MIFFileName MIFPublisher MIFName MIFVersion e, respectivamente. Estes parâmetros e propriedades devem conter os mesmos valores.

Requisitos

Windows NT/2000: Requer Windows 2000 ou mais tarde.

Versão: Requer SMS 2003 Cliente Avançado.

Biblioteca: Incluído como recurso em IsMIF32.dll (C/C++).

Consulte também

Funções MIF de estado
Instalar o EstatísticasMIF
Classe WMI do servidor de SMS_Package

Partilhar via