Funzione CloneEnumWbemClassObject
Crea una copia logica di un enumeratore mantenendone la posizione corrente in un'enumerazione.
Nota
Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.
Sintassi
HRESULT CloneEnumWbemClassObject (
[out] IEnumWbemClassObject** ppEnum,
[in] DWORD authLevel,
[in] DWORD impLevel,
[in] IEnumWbemClassObject* pCurrentEnumWbemClassObject,
[in] BSTR strUser,
[in] BSTR strPassword,
[in BSTR] strAuthority
);
Parametri
ppEnum
[out] Riceve un puntatore a un nuovo oggetto IEnumWbemClassObject.
authLevel
[in] Livello di autorizzazione.
impLevel
[in] Livello di rappresentazione.
pCurrentEnumWbemClassObject
[out] Puntatore all'istanza di IEnumWbemClassObject da clonare.
strUser
[in] Nome utente. Per altre informazioni, vedere la funzione ConnectServerWmi .
strPassword
[in] Password. Per altre informazioni, vedere la funzione ConnectServerWmi .
strAuthority
[in] Nome di dominio dell'utente. Per altre informazioni, vedere la funzione ConnectServerWmi .
Valore restituito
I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:
| Costante | Valore | Descrizione |
|---|---|---|
WBEM_E_FAILED |
0x80041001 | Si è verificato un errore generale. |
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un parametro non è valido. |
WBEM_E_OUT_OF_MEMORY |
0x80041006 | Memoria insufficiente è disponibile per completare l'operazione. |
WBEM_E_TRANSPORT_FAILURE |
0x80041015 | Il collegamento rpc (Remote Procedure Call) tra il processo corrente e WMI non è riuscito. |
WBEM_S_NO_ERROR |
0 | La chiamata alla funzione ha avuto esito positivo. |
Commenti
Questa funzione esegue il wrapping di una chiamata al metodo IEnumWbemClassObject::Clone .
Questo metodo esegue solo una copia "best effort". A causa della natura dinamica di molti oggetti CIM, è possibile che il nuovo enumeratore non enumera lo stesso set di oggetti dell'enumeratore di origine.
Se la chiamata alla funzione ha esito negativo, è possibile ottenere informazioni di errore aggiuntive chiamando la funzione GetErrorInfo .
Esempio
Per un esempio, vedere il metodo IEnumWbemClassObject::Clone .
Requisiti
Piattaforme: vedere Requisiti di sistema di .NET Framework.
Intestazione: WMINet_Utils.idl
Versioni di .NET Framework: Disponibile da 4.7.2
