Compartilhar via

função MI_Application_InitializeV1 (mi.h)

  • Artigo

Inicializa um aplicativo para que ele possa fazer chamadas à API do cliente da MI (Infraestrutura de Gerenciamento).

Sintaxe

MI_Result MI_MAIN_CALL MI_Application_InitializeV1(
                  MI_Uint32      flags,
  [in, optional]  const MI_Char  *applicationID,
  [out, optional] MI_Instance    **extendedError,
  [out]           MI_Application *application
);

Parâmetros

flags

Deve ser 0.

[in, optional] applicationID

Uma cadeia de caracteres opcional (geralmente GUID no formato de cadeia de caracteres) para representar um aplicativo cliente. Essa cadeia de caracteres pode ser usada para configuração específica do aplicativo e registro em log específico do aplicativo.

[out, optional] extendedError

Parâmetro opcional que fornecerá mais informações de erro se a operação falhou. Se uma instância for retornada, MI_Instance_Delete deverá ser chamado para liberá-la quando não for mais necessária.

[out] application

Um ponteiro para um identificador de MI_Application não inicializado é passado e um identificador preenchido é retornado. O identificador inicializado deve ser passado para MI_Application_Close antes que o aplicativo seja desligado. Se um aplicativo passar esse identificador, passe-o por valor em vez de como um ponteiro.

Retornar valor

Essa função retorna MI_Result MI_MAIN_CALL.

Comentários

Essa API precisa ser chamada apenas uma vez por aplicativo; embora possa ser chamado várias vezes com segurança. Chamar essa API várias vezes resultará em uma pequena quantidade de uso extra de memória. Quando chamado, o aplicativo passa um ponteiro MI_Application a ser inicializado. Esse ponteiro deve ser fechado chamando MI_Application_Close. Não fazer isso causará perdas de memória e possíveis falhas durante o desligamento.

MI.h define MI_Application_Initialize como MI_Application_InitializeV1 com esta linha:

#define MI_Application_Initialize MI_Application_InitializeV1

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Windows
Cabeçalho mi.h
Biblioteca Mi.lib
DLL Mi.dll
Redistribuível Windows Management Framework 3.0 no Windows Server 2008 R2 com SP1, Windows 7 com SP1 e Windows Server 2008 com SP2