Função InstallStatusMIF

A InstallStatusMIF função cria um arquivo status Formato de Informações de Gerenciamento (MIF) que Configuration Manager usa para correlacionar o status 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 exclusivo para o arquivo 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 está limitado a 16 caracteres.

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

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

bStatus trueSe o status da instalação for Bem-sucedido.

Return Values

Um valor diferente de zero para indicar êxito.

Comentários

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

Observe que 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.

A InstallStatusMIF função é fornecida em uma versão de 32 bits (Ismif32.dll) e uma versão de 16 bits (Ismif16.dll). A DLL apropriada é instalada no computador cliente durante o processo de instalação do cliente do Configuration Manager.

O exemplo na próxima seção mostra como chamar a InstallStatusMIF função usando o arquivo Ismif32.dll diretamente. Uma falha ao carregar o arquivo Ismif32.dll pode indicar que o sistema não é um cliente Configuration Manager.

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 o Windows NT 4.0 ou posterior.

Windows 95/98: requer o Windows 95 ou posterior.

Versão: Requer SMS 2.0.

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

Confira também

Status Funções MIFSMS_Package Classe WMI do Servidor