NextMethod 関数

  • [アーティクル]

BeginMethodEnumeration の呼び出しによって開始された列挙内の次のメソッドが取得されます。

Note

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

構文

HRESULT NextMethod (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pName,
   [out] IWbemClassObject** ppInSignature,
   [out] IWbemClassObject** ppOutSignature
);

パラメーター

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

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

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

pName
[out] 呼び出しの前の null を指すポインター。 関数から制御が戻るときに、メソッド名を含む新しい BSTR のアドレスが返されます。

ppSignatureIn
[out] メソッドの in パラメーターを格納している IWbemClassObject へのポインターを受け取るポインター。

ppSignatureOut
[out] メソッドの out パラメーターを格納している IWbemClassObject へのポインターを受け取るポインター。

戻り値

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

定数 値 説明
WBEM_E_UNEXPECTED 0x8004101d BeginEnumeration 関数の呼び出しがありませんでした。
WBEM_S_NO_ERROR 0 関数呼び出しは成功しました。
WBEM_S_NO_MORE_DATA 0x40005 列挙にはこれ以上プロパティがありません。

解説

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

呼び出し元では、BeginMethodEnumeration 関数を呼び出すことで列挙シーケンスが開始され、関数から WBEM_S_NO_MORE_DATA が返されるまで [NextMethod] 関数が呼び出されます。 必要に応じて、呼び出し元では EndMethodEnumeration を呼び出すことによってシーケンスを終了します。 呼び出し元は、いつでも EndMethodEnumeration を呼び出すことによって列挙を早期に終了できます。

例

C++ の例については、「IWbemClassObject::NextMethod メソッド」を参照してください。

必要条件

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

ヘッダー: WMINet_Utils.idl

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

関連項目