次の方法で共有

QualifierSet_Next 関数

QualifierSet_BeginEnumeration 関数の呼び出しによって開始された列挙型内の次の修飾子が返されます。

Note

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

構文

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

パラメーター

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

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

lFlags [in] 予約されています。 このパラメーターは、0 にする必要があります。

pstrName [out] 修飾子の名前。 null の場合、このパラメーターは無視されます。それ以外の場合、pstrName は有効な BSTR を指していないか、メモリ リークが発生しています。 null 値以外の場合、関数では、WBEM_S_NO_ERROR を返すときに常に新しい BSTR が割り当てられます。

pVal [out] 成功した場合は、修飾子の値。 関数が失敗した場合、pVal が指す VARIANT を変更することはできません。 このパラメーターが null の場合、このパラメーターは無視されます。

plFlavor [out] 修飾子の種類を受け取る LONG へのポインター。 種類の情報が必要でない場合は、このパラメーターを null にすることができます。

戻り値

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

定数 [値] 説明
WBEM_E_INVALID_PARAMETER 0x80041008 パラメーターが無効です。
WBEM_E_UNEXPECTED 0x8004101d 呼び出し元によって QualifierSet_BeginEnumeration が呼び出されませんでした。
WBEM_E_OUT_OF_MEMORY 0x80041006 新しい列挙を開始するのに十分なメモリがありません。
WBEM_S_NO_MORE_DATA 0x40005 列挙内にはそれ以上修飾子が残されていません。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。

解説

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

QualifierSet_Next 関数を繰り返し呼び出して、関数から WBEM_S_NO_MORE_DATA が返されるまですべての修飾子を列挙します。 列挙を早期に終了するには、QualifierSet_EndEnumeration 関数を呼び出します。

列挙中に返される修飾子の順序は定義されていません。

必要条件

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

ヘッダー: WMINet_Utils.idl

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

関連項目

  • Last updated on