Función CloneEnumWbemClassObject
Realiza una copia lógica de un enumerador conservando su posición actual en una enumeración.
Nota
Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.
Sintaxis
HRESULT CloneEnumWbemClassObject (
[out] IEnumWbemClassObject** ppEnum,
[in] DWORD authLevel,
[in] DWORD impLevel,
[in] IEnumWbemClassObject* pCurrentEnumWbemClassObject,
[in] BSTR strUser,
[in] BSTR strPassword,
[in BSTR] strAuthority
);
Parámetros
ppEnum
[out] El valor de este parámetro se corresponde con un puntero que apunta a un nuevo objeto de tipo IEnumWbemClassObject.
authLevel
[in] El valor de este parámetro se corresponde con el nivel de autorización.
impLevel
[in] El valor de este parámetro se corresponde con el nivel de suplantación.
pCurrentEnumWbemClassObject
[out] El valor de este parámetro se corresponde con un puntero que apunta a la instancia de la interfaz IEnumWbemClassObject que se va a clonar.
strUser
[in] El valor de este parámetro se corresponde con el nombre de usuario. Consulte la función ConnectServerWmi para obtener más información.
strPassword
[in] El valor de este parámetro se corresponde con la contraseña. Consulte la función ConnectServerWmi para obtener más información.
strAuthority
[in] El valor de este parámetro se corresponde con el nombre de dominio del usuario. Consulte la función ConnectServerWmi para obtener más información.
Valor devuelto
Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:
| Constante | Value | Descripción |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | Si se devuelve este valor, significará que se ha producido un error general. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Si se devuelve este valor, significará que el parámetro en cuestión no es válido. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Si se devuelve este valor, significará que no hubo suficiente memoria para completar la operación. |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | Si se devuelve este valor, significará que ha ocurrido un error en el vínculo de llamada a procedimiento remoto (RPC) entre el proceso actual y WMI. |
WBEM_S_NO_ERROR |
0 | Si se devuelve este valor, significará que la llamada a la función se realizó correctamente. |
Comentarios
Al usar esta función, se ajusta una llamada al método IEnumWbemClassObject::Clone.
No es posible garantizar los resultados de las copias que se crean mediante este método. Debido a la naturaleza dinámica de muchos objetos CIM, es posible que el nuevo enumerador no enumere el mismo conjunto de objetos que el enumerador de origen.
Si se produce un error en la llamada a la función, podrá obtener información adicional sobre este mediante una llamada a la función GetErrorInfo.
Ejemplo
Para obtener un ejemplo, consulte el método IEnumWbemClassObject::Clone.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: WMINet_Utils.idl
Versiones de .NET Framework: está disponible desde la versión 4.7.2
