Função InstallStatusMIF
A InstallStatusMIF função cria um arquivo MIF (formato de informações de gerenciamento de status) 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 editor do produto, por exemplo, Microsoft. Esse parâmetro é limitado a 64 caracteres.
pszProduct
Ponteiro para o nome do produto ou do 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 país/região ou código de idioma, por exemplo, ENU. Esse parâmetro é opcional e é limitado a 16 caracteres.
pszSerialNo
Ponteiro para o número de série do produto. Esse parâmetro é opcional e é limitado a 64 caracteres.
pszMessage
Ponteiro para uma mensagem descritiva sobre o status da instalação, adicionada à mensagem de status do programa. Esse parâmetro é limitado a 128 caracteres.
bStatus
true se o status de instalação for bem-sucedido.
Return Values
Um valor não zero para indicar êxito.
Comentários
Seu aplicativo de instalação (instalação) deve criar apenas um arquivo MIF de status de instalação para o pacote. O nome do arquivo que você especificar deve ser exclusivo.
As instalações executadas em versões localizadas de Configuration Manager devem especificar valores no formato apropriado: formato ANSI para idiomas europeus; Formato DBCS para idiomas da Ásia Oriental.
Seu aplicativo deve chamar InstallStatusMIF antes da saída da instalação. O arquivo MIF não será relatado para 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 servidor SMS_Package , 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 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 Windows NT 4.0 ou posterior.
Windows 95/98: requer Windows 95 ou posterior.
Versão: requer SMS 2.0.
Biblioteca: incluído como um recurso no Ismif32.dll (C/C++); Ismif16.dll (C/C++).