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

另请参阅