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] 接收 IWbemClassObject 指標的指標,其包含方法的 in
參數。
ppSignatureOut
[out] 接收 IWbemClassObject 指標的指標,其包含方法的 out
參數。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中,或者,您可以將其定義為程式碼中的常數:
常數 | 值 | 描述 |
---|---|---|
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 起提供