Função InstallStatusMIF

Artigo
08/14/2021

A InstallStatusMIF função cria um ficheiro formato de informação de gestão de estado (MIF) que o Gestor de Configuração utiliza para correlacionar o estado de instalação de um anúncio.

Sintaxe

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

Parâmetros

pszFileName
Ponteiro para um nome único para o ficheiro 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 está limitado a 16 caracteres.

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

pszMessage
Ponteiro para uma mensagem descritiva sobre o estado da instalação, 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.

Valores de devolução

Um valor não-zero para indicar sucesso.

Observações

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 InstallStatusMIF 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 InstallStatusMIF .

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.

A InstallStatusMIF função é fornecida numa versão de 32 bits (Ismif32.dll) e numa versão de 16 bits (Ismif16.dll). O DLL apropriado é instalado no computador cliente durante o processo de instalação do cliente Do Gestor de Configuração.

O exemplo na secção seguinte mostra como ligar a InstallStatusMIF função utilizando o ficheiro Ismif32.dll diretamente. Uma falha no carregamento do ficheiro Ismif32.dll pode indicar que o sistema não é um cliente Gestor de Configuração.

Exemplo

[C/C++]  
DWORD (WINAPI *InstallStatusMIF)(char *, char *, char *, char *, char *, char *, char *, BOOL);  

#define PROCSIGNATURE DWORD (WINAPI *)(char *, char *, char *, char *, char *, char *, char *, BOOL)  

    HINSTANCE  hinst;  
    int  RetCode;  

    hinst = LoadLibrary("ismif32.dll");  

    InstallStatusMIF = (PROCSIGNATURE) GetProcAddress(hinst, "InstallStatusMIF");  

    if (InstallStatusMIF)  
    {  
        RetCode = InstallStatusMIF("Status",  
                                   "Microsoft",  
                                   "Microsoft SQL Server 7.0",  
                                   "7.00.000",  
                                   "ENU",  
                                   NULL,  
                                   "Installation Successful",  
                                   true);  
    }  
    FreeLibrary(hinst);

Requisitos

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

Windows 95/98: Requer Windows 95 ou mais tarde.

Versão: Requer SMS 2.0.

Biblioteca: Incluído como recurso em Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Consulte também

Funções MIF de estado
Classe WMI do servidor de SMS_Package

Partilhar via