BeginEnumeration 関数

  • [アーティクル]

列挙子を列挙の先頭にリセットします。

Note

この API は、内部でだけ使用します。 開発者コードで使用するためのものではありません。

構文

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

パラメーター

vFunc
[in] このパラメーターは使用されません。

ptr
[in] IWbemClassObject インスタンスへのポインター。

lEnumFlags
[in] 列挙に含まれるプロパティを制御する、「解説」セクションで説明されているフラグまたは値のビットごとの組み合わせ。

戻り値

この関数によって返される次の値は、WbemCli.h ヘッダー ファイル内で定義されています。または、コード内で定数として定義することもできます。

定数 [値] 説明
WBEM_E_INVALID_PARAMETER 0x80041008 lEnumFlags のフラグの組み合わせが無効であるか、無効な引数が指定されました。
WBEM_E_UNEXPECTED 0x8004101d BeginEnumeration への 2 回目の呼び出しは、EndEnumeration への中間呼び出しなしで行われました。
WBEM_E_OUT_OF_MEMORY 0x80041006 新しい列挙を開始するのに十分なメモリがありません。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。

解説

この関数では、IWbemClassObject::BeginEnumeration メソッドの呼び出しがラップされます。

lEnumFlags 引数として渡すことができるフラグは、WbemCli.h ヘッダー ファイル内で定義されているか、コード内で定数として定義することができます。 各グループのフラグを他のグループの任意のフラグと組み合わせることができます。 ただし、同じグループのフラグは相互に排他的です。

グループ 1

定数 [値] 説明
WBEM_FLAG_KEYS_ONLY 0x4 キーを構成するプロパティだけを含めます。
WBEM_FLAG_REFS_ONLY 0x8 オブジェクト参照であるプロパティだけを含めます。

グループ 2

定数 [値] 説明
WBEM_FLAG_SYSTEM_ONLY 0x30 列挙をシステム プロパティのみに制限します。
WBEM_FLAG_NONSYSTEM_ONLY 0x40 ローカルおよび伝播されたプロパティを含めますが、システム プロパティは列挙から除外します。

クラスの場合:

定数 [値] 説明
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 列挙を、クラス定義でオーバーライドされたプロパティに限定します。
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 列挙を、現在のクラス定義でオーバーライドされたプロパティと、クラス内で定義されている新しいプロパティに限定します。
WBEM_MASK_CLASS_CONDITION 0x300 WBEM_FLAG_CLASS_OVERRIDES_ONLY または WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES が設定されているかどうかを確認するために、lEnumFlags 値に対して適用するマスク (フラグではない)。
WBEM_FLAG_LOCAL_ONLY 0x10 列挙を、クラス自体で定義または変更されたプロパティに限定します。
WBEM_FLAG_PROPAGATED_ONLY 0x20 列挙を、基底クラスから継承されたプロパティに限定します。

インスタンスの場合:

定数 [値] 説明
WBEM_FLAG_LOCAL_ONLY 0x10 列挙を、クラス自体で定義または変更されたプロパティに限定します。
WBEM_FLAG_PROPAGATED_ONLY 0x20 列挙を、基底クラスから継承されたプロパティに限定します。

必要条件

:「システム要件」を参照してください。

ヘッダー: WMINet_Utils.idl

.NET Framework のバージョン: 4.7.2 以降で使用可能

関連項目