Função InstallStatusMIF

A InstallStatusMIF função cria um ficheiro MIF (Management Information Format) status que Configuration Manager utiliza 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 ficheiro 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, adicionada ao programa status mensagem. Este parâmetro está limitado a 128 carateres.

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

Return Values

Um valor diferente de zero para indicar êxito.

Comentários

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 InstallStatusMIF antes de a instalação sair. O ficheiro MIF não é comunicado ao Configuration Manager se a instalação criar outro processo que chame InstallStatusMIF.

Tenha em atenção que 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.

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

O exemplo na secção seguinte mostra como chamar a InstallStatusMIF função com o ficheiro Ismif32.dll diretamente. Uma falha ao carregar o ficheiro 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 Windows NT 4.0 ou posterior.

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

Versão: requer SMS 2.0.

Biblioteca: incluída como um recurso no Ismif32.dll (C/C++); Ismif16.dll (C/C++).

Confira também

Estado das Funções MIFSMS_Package Classe WMI de Servidor