CloneEnumWbemClassObject 函式
建立列舉程式的邏輯複本，並保留其在列舉中的目前位置。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT CloneEnumWbemClassObject (
[out] IEnumWbemClassObject** ppEnum,
[in] DWORD authLevel,
[in] DWORD impLevel,
[in] IEnumWbemClassObject* pCurrentEnumWbemClassObject,
[in] BSTR strUser,
[in] BSTR strPassword,
[in BSTR] strAuthority
);
參數
ppEnum
[out] 接收新 IEnumWbemClassObject的指標。
authLevel
[in] 授權等級。
impLevel
[in] 模擬等級。
pCurrentEnumWbemClassObject
[out] 欲複製 IEnumWbemClassObject 實例的指標。
strUser
[in] 使用者名稱。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
strPassword
[in] 密碼。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
strAuthority
[in] 使用者的網域名稱。 如需詳細資訊，請參閱 ConnectServerWmi 函式。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | 發生一般失敗。 |
WBEM_E_INVALID_PARAMETER |
0x80041008 | 有一個參數無效。 |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | 可用的記憶體不足，無法完成作業。 |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | 目前處理序與 WMI 之間的遠端程序呼叫 (RPC) 連結失敗。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝對 IEnumWbemClassObject::Clone 方法的呼叫。
這個方法只會製作「最佳」複本。 由於許多 CIM 物件的動態本質，新的列舉值可能不會列舉與來源列舉值相同的物件集合。
如果函式呼叫失敗，您可以藉由呼叫 GetErrorInfo 函式來取得其他錯誤資訊。
範例
如需範例，請參閱 IEnumWbemClassObject::Clone 方法。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
