funzione MI_Application_InitializeV1 (mi.h)

Articolo
03/09/2023

Inizializza un'applicazione in modo che possa effettuare chiamate API client dell'infrastruttura di gestione.Initialize an application so that it can make Management Infrastructure (MI) client API calls.

Sintassi

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
);

Parametri

flags

Deve essere 0.

[in, optional] applicationID

Stringa facoltativa (in genere GUID in formato stringa) per rappresentare un'applicazione client. Questa stringa può essere usata per la configurazione specifica dell'applicazione e la registrazione specifica dell'applicazione.

[out, optional] extendedError

Parametro facoltativo che fornisce altre informazioni sull'errore se l'operazione non è riuscita. Se viene restituita un'istanza, MI_Instance_Delete deve essere chiamata per liberarla quando non è più necessaria.

[out] application

Viene passato un puntatore a un handle di MI_Application non inizializzato e viene restituito un handle popolato. L'handle inizializzato deve essere passato a MI_Application_Close prima dell'arresto dell'applicazione. Se un'applicazione passa questo handle, passarlo per valore anziché come puntatore.

Valore restituito

Questa funzione restituisce MI_Result MI_MAIN_CALL.

Commenti

Questa API deve essere chiamata una sola volta per applicazione; anche se può essere chiamato più volte in modo sicuro. La chiamata a questa API più volte comporterà una piccola quantità di utilizzo aggiuntivo della memoria. Quando viene chiamato, l'applicazione passa un puntatore MI_Application da inizializzare. Questo puntatore deve essere chiuso chiamando MI_Application_Close. Questa operazione non causa perdite di memoria e potenziali arresti anomali durante l'arresto.

MI.h definisce MI_Application_Initialize come MI_Application_InitializeV1 con questa riga:

#define MI_Application_Initialize MI_Application_InitializeV1

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8
Server minimo supportato	Windows Server 2012
Piattaforma di destinazione	Windows
Intestazione	mi.h
Libreria	Mi.lib
DLL	Mi.dll
Componente ridistribuibile	Windows Management Framework 3.0 in Windows Server 2008 R2 con SP1, Windows 7 con SP1 e Windows Server 2008 con SP2

Condividi tramite