MI_Application_InitializeV1-Funktion (mi.h)

Initialisiert eine Anwendung, sodass sie Client-API-Aufrufe der Verwaltungsinfrastruktur (MI) durchführen kann.

Syntax

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

Parameter

flags

Muss den Wert 0 (null) haben.

[in, optional] applicationID

Eine optionale Zeichenfolge (in der Regel GUID im Zeichenfolgenformat), um eine Clientanwendung darzustellen. Diese Zeichenfolge kann für die anwendungsspezifische Konfiguration und anwendungsspezifische Protokollierung verwendet werden.

[out, optional] extendedError

Optionaler Parameter, der weitere Fehlerinformationen angibt, wenn der Vorgang fehlgeschlagen ist. Wenn ein instance zurückgegeben wird, muss MI_Instance_Delete aufgerufen werden, um ihn freizugeben, wenn er nicht mehr benötigt wird.

[out] application

Ein Zeiger auf ein nicht initialisiertes MI_Application Handle wird übergeben, und ein aufgefülltes Handle wird zurückgegeben. Das initialisierte Handle muss an MI_Application_Close übergeben werden, bevor die Anwendung heruntergefahren wird. Wenn eine Anwendung dieses Handle übergibt, übergeben Sie es nach Wert und nicht als Zeiger.

Rückgabewert

Diese Funktion gibt MI_Result MI_MAIN_CALL zurück.

Hinweise

Diese API muss nur einmal pro Anwendung aufgerufen werden. es kann jedoch mehrmals sicher aufgerufen werden. Das mehrfache Aufrufen dieser API führt zu einer geringen zusätzlichen Speicherauslastung. Beim Aufruf übergibt die Anwendung einen MI_Application Zeiger, der initialisiert werden soll. Dieser Zeiger muss durch Aufrufen von MI_Application_Close geschlossen werden. Andernfalls kommt es während des Herunterfahrens zu Speicherverlusten und potenziellen Abstürzen.

MI.h definiert MI_Application_Initialize als MI_Application_InitializeV1 mit dieser Zeile:

#define MI_Application_Initialize MI_Application_InitializeV1

Anforderungen