IWbemContext::GetNames メソッド (wbemcli.h)

IWbemContext::GetNames メソッドは、名前付きコンテキスト値のすべての名前の SAFEARRAY 構造体を返します。 すべての名前がわかったら、各名前で GetValue を呼び出して値を取得できます。 この手法は、 BeginEnumeration、 Next、 EndEnumeration メソッドの呼び出しとは異なるコンテキスト値にアクセスする方法です。

構文

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

パラメーター

[in] lFlags

予約済み。 このパラメーターは、0 にする必要があります。

[out] pNames

このパラメーターは NULL にすることはできませんが、エントリでは NULL を指す必要があります。 エラーが返されない場合、終了時 に pstrNames は、すべてのコンテキスト値名を含むVT_BSTR型の新しい SAFEARRAY 構造体へのポインターを受け取ります。 配列が不要になった場合、呼び出し元は返されたポインターで SafeArrayDestroy を呼び出す必要があります。 エラー コードが返された場合、ポインターは変更されません。

メモ オブジェクトに名前付き値がない場合、呼び出しは成功し、長さ 0 の配列を返します。

 

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。

解説

BSTR 値の SAFEARRAY 構造体の使用の詳細については、「WMI インスタンスの一部を取得する」を参照してください。

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)
Library	Wbemuuid.lib
[DLL]	Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wmipjobj.dll

関連項目

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue