次の方法で共有

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

  • [アーティクル]

IWbemContext::Next メソッドは、IWbemContext::BeginEnumeration で始まるすべてのコンテキスト値の列挙で次の値を取得します。

構文

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pValue
);

パラメーター

[in] lFlags

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

[out] pstrName

このパラメーターを NULL にすることはできません。 ポインターは、エントリ時にアクティブな BSTR を指す必要はありません。理想的には 、NULL をポイントするように設定する必要があります。 エラー コードが返されない場合は、コンテキスト値名を含む新しく割り当てられた BSTR を指すように設定されます。

呼び出し元は、不要になったときに返された文字列に 対して SysFreeString を呼び出す必要があります。 WBEM_S_NO_MORE_DATAが返された場合、pstrName は NULL を指すように設定されます。この場合、SysFreeString を呼び出さないでください。 pstrName がエントリの有効な BSTR を指している場合、この BSTR は解放されず、メモリ リークが発生します。

[out] pValue

このパラメーターは NULL にすることはできません。また、空または初期化されていない VARIANT を指す必要があります。 エラーが返されない場合、 VARIANT は VariantInit を使用して初期化され、コンテキスト値を格納するように設定されます。 値が不要になった場合、呼び出し元はこのポインターで VariantClear を呼び出す必要があります。 エラー コードが返された場合、pValue が指す VARIANT は変更されません。

WBEM_S_NO_MORE_DATAが返された場合、このパラメーターは VT_NULL 型の VARIANT を指すように設定されます。

IWbemClassObject オブジェクト全体が VARIANT 内で返される可能性があります。 その場合、 VT_UNKNOWN は VARIANT 型です。 呼び出し元は IUnknown ポインターを取得し、 QueryInterface を 実行して IWbemClassObject ポインターを取得できます。

メモ 列挙の最後に、 WBEM_S_NO_MORE_DATA が返されます。 返される VARIANT は VT_NULL型で、返される pstrName は NULL です。
 

戻り値

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

要件

   
サポートされている最小のクライアント 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::EndEnumeration