NextMethod 函数

检索某个枚举中的下一个方法,该枚举从对 BeginMethodEnumeration 的调用开始。

注意

此 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 头文件中定义的,你也可以在代码中将这些值定义为常数:

常数 Value 说明
WBEM_E_UNEXPECTED 0x8004101d 没有对 BeginEnumeration 函数的调用。
WBEM_S_NO_ERROR 0 函数调用成功。
WBEM_S_NO_MORE_DATA 0x40005 枚举中没有更多属性。

注解

此函数包装对 IWbemClassObject::NextMethod 方法的调用。

调用方通过调用 BeginMethodEnumeration 函数开始枚举序列,然后调用 [NextMethod] 函数,直到该函数返回 WBEM_S_NO_MORE_DATA 为止。 (可选)调用方可以通过调用 EndMethodEnumeration 来完成序列。 调用方可以随时通过调用 EndMethodEnumeration 来提前终止枚举。

示例

有关 C++ 示例,请参阅 IWbemClassObject::NextMethod 方法。

要求

平台:请参阅系统要求

标头:WMINet_Utils.idl

.NET Framework 版本:自 4.7.2 起可用

另请参阅