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