次の方法で共有

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 は、アプリケーションごとに 1 回だけ呼び出す必要があります。ただし、複数回安全に呼び出すことができます。 この 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
Library Mi.lib
[DLL] Mi.dll
再頒布可能パッケージ Windows Server 2008 R2 sp1、Windows 7 SP1、Windows Server 2008 SP2 で 3.0 をWindows Management Frameworkする