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

  • [アーティクル]

IWbemClassObject::Next メソッドは、IWbemClassObject::BeginEnumeration で始まった列挙体の次のプロパティを取得します。 これは、 WBEM_S_NO_MORE_DATA が返されるまで、すべてのプロパティを列挙するために繰り返し呼び出す必要があります。 列挙体を早期に終了する場合は、 IWbemClassObject::EndEnumeration を呼び出す必要があります。

列挙中に返されるプロパティの順序は定義されていません。

構文

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

パラメーター

[in] lFlags

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

[out] strName

プロパティ名を含む新しい BSTR を受け取ります。 クライアント プロセスでメモリ リークを防ぐために、呼び出し元は名前が不要になったときに SysFreeString を呼び出す必要があります。 名前が不要な場合は、このパラメーターを NULL に 設定できます。

[out] pVal

この VARIANT には、 プロパティの値が入力されます。 メソッドはこの VARIANT に対して VariantInit を呼び出すので、呼び出し元は呼び出し前に VARIANT がアクティブでないことを確認する必要があります。 値が不要になった場合、呼び出し元は VariantClear を 使用する必要があります。

値が不要な場合は、このパラメーターを NULL に設定できます。 エラー コードが返された場合、pVal が指す VARIANT は変更されません。

[out, optional] pType

このパラメーターは、NULL でもかまいません。 NULL でない場合は、プロパティの型が配置される CIMTYPE 変数 (LONG) を指す必要があります。 このプロパティの値は 、VT_NULLVARIANT である可能性があります。その場合は、プロパティの実際の型を決定する必要があります。

[out, optional] plFlavor

NULL を指定できます。 NULL でない場合、 が指す LONG 値は、プロパティの原点に関する情報を次のように受け取ります。 詳細については、「修飾子の フレーバー と WBEM_FLAVOR_TYPE」を参照してください。

WBEM_FLAVOR_ORIGIN_SYSTEM

プロパティは、標準のシステム プロパティです。

クラスの場合:

WBEM_FLAVOR_ORIGIN_PROPAGATED

プロパティは親クラスから継承されました。

プロパティは親クラスから継承されますが、インスタンス レベルでは変更されていません。

WBEM_FLAVOR_ORIGIN_LOCAL

プロパティは、派生した最上位クラスに属します。

プロパティは、インスタンス レベルで変更されます (つまり、値が指定されたか、修飾子が追加または変更されました)。

インスタンスの場合:

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。 一般的な HRESULT 値については、「 システム エラー コード」を参照してください。

解説

プロパティの基になる型がオブジェクト パス、日付または時刻、または他の特殊な型である場合、返される型には十分な情報が含まれません。 呼び出し元は、指定されたプロパティの CIMTYPE を調べて、プロパティがオブジェクト参照、日付または時刻、または別の特殊な型であるかどうかを判断する必要があります。

このメソッドは 、システム プロパティも返します。

要件

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

関連項目

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::EndEnumeration

IWbemClassObject::Get

WMI システムのプロパティ