Clone 函式
傳回屬於目前物件之完整複製品的新物件。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT Clone (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[out] IWbemClassObject** ppCopy
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
ppCopy
[out]新的物件,這個物件是 ptr
的完整複製。 如果這個引數收到目前物件的複本,則引數不可為 null
。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中,或者,您可以將其定義為程式碼中的常數:
常數 | 值 | 描述 |
---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生一般失敗。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | null 已指定為參數,而且在此用法中不合法。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足,無法進行物件複製。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝對 IEnumWbemClassObject::Clone 方法的呼叫。
複製的物件是一個 COM 物件,其參考計數為 1。
規格需求
平台:請參閱系統需求。
標頭:WMINet_Utils.idl
.NET Framework版本:自 4.7.2 起可用