MI_Application_InitializeV1函式 (mi.h)

  • 發行項

初始化應用程式，使其可以在 MI) 用戶端 API 呼叫 (管理基礎結構。

語法

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

參數

flags

必須是 0。

[in, optional] applicationID

選擇性字串 (通常以字串格式) GUID 來表示用戶端應用程式。 此字串可用於應用程式特定組態和應用程式特定的記錄。

[out, optional] extendedError

如果作業失敗，選擇性參數會提供更多錯誤資訊。 如果傳回實例，則必須呼叫 MI_Instance_Delete ，才能在不再需要時釋放它。

[out] application

傳入未初始化 MI_Application 句柄的指標，並傳回填入的句柄。 初始化的句柄必須先傳遞至 MI_Application_Close ，應用程式才會關閉。 如果應用程式傳遞此句柄，請依值傳遞它，而不是做為指標。

傳回值

此函式會傳回MI_Result MI_MAIN_CALL。

備註

每個應用程式只需要呼叫此 API 一次;雖然可以安全地呼叫多次。 多次呼叫此 API 會導致少量額外的記憶體使用量。 呼叫時，應用程式會傳入要初始化 MI_Application 指標。 呼叫 MI_Application_Close 必須關閉此指標。 不這麼做會導致記憶體流失，而且在關機期間可能會當機。

MI.h 使用這一行將 MI_Application_Initialize 定義為 MI_Application_InitializeV1 ：

#define MI_Application_Initialize MI_Application_InitializeV1

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
目標平台 Windows
標頭 mi.h
程式庫 Mi.lib
Dll Mi.dll
可轉散發套件 windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 Windows Management Framework 3.0