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 起可用