Função CloneEnumWbemClassObject
Faz uma cópia lógica de um enumerador, mantendo a sua posição atual numa enumeração.
Nota
Esta API destina-se apenas a utilização interna. Não se destina a ser utilizado a partir do código do programador.
Sintaxe
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
[fora] Recebe um ponteiro para um novo IEnumWbemClassObject.
authLevel
[in] O nível de autorização.
impLevel
[in] O nível de representação.
pCurrentEnumWbemClassObject
[fora] Um ponteiro para a instância IEnumWbemClassObject a clonar.
strUser
[in] O nome de utilizador. Veja a função ConnectServerWmi para obter mais informações.
strPassword
[in] A palavra-passe. Veja a função ConnectServerWmi para obter mais informações.
strAuthority
[in] O nome de domínio do utilizador. Veja a função ConnectServerWmi para obter mais informações.
Valor devolvido
Os seguintes valores devolvidos por esta função são definidos no ficheiro de cabeçalho WbemCli.h ou pode defini-los como constantes no seu código:
| Constante | Valor | Descrição |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | Houve uma falha geral. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Um parâmetro é inválido. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Não existe memória suficiente disponível para concluir a operação. |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | A ligação de chamada de procedimento remoto (RPC) entre o processo atual e a WMI falhou. |
WBEM_S_NO_ERROR |
0 | A chamada da função foi efetuada com êxito. |
Observações
Esta função encapsula uma chamada para o método IEnumWbemClassObject::Clone .
Este método faz apenas uma cópia do "melhor esforço". Devido à natureza dinâmica de muitos objetos CIM, é possível que o novo enumerador não enumera o mesmo conjunto de objetos que o enumerador de origem.
Se a chamada da função falhar, pode obter informações de erro adicionais ao chamar a função GetErrorInfo .
Exemplo
Por exemplo, veja o método IEnumWbemClassObject::Clone .
Requisitos
Plataformas: Veja Requisitos de Sistema.
Cabeçalho: WMINet_Utils.idl
.NET Framework Versões: Disponível desde a versão 4.7.2
