CloneEnumWbemClassObject, functie

Hiermee maakt u een logische kopie van een enumerator, waarbij de huidige positie in een opsomming behouden blijft.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit ontwikkelaarscode.

Syntaxis

HRESULT CloneEnumWbemClassObject (
   [out] IEnumWbemClassObject**  ppEnum,
   [in] DWORD                    authLevel,
   [in] DWORD                    impLevel,
   [in] IEnumWbemClassObject*    pCurrentEnumWbemClassObject,
   [in] BSTR                     strUser,
   [in] BSTR                     strPassword,
   [in BSTR]                     strAuthority
);

Parameters

ppEnum
[uit] Ontvangt een aanwijzer naar een nieuw IEnumWbemClassObject.

authLevel
[in] Het autorisatieniveau.

impLevel
[in] Het imitatieniveau.

pCurrentEnumWbemClassObject
[uit] Een verwijzing naar het IEnumWbemClassObject-exemplaar dat moet worden gekloond.

strUser
[in] De gebruikersnaam. Zie de functie ConnectServerWmi voor meer informatie.

strPassword
[in] Het wachtwoord. Zie de functie ConnectServerWmi voor meer informatie.

strAuthority
[in] De domeinnaam van de gebruiker. Zie de functie ConnectServerWmi voor meer informatie.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h . U kunt ze ook definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_FAILED	0x80041001	Er is een algemene fout opgetreden.
WBEM_E_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_E_TRANSPORT_FAILURE	0x80041015	De koppeling externe procedureaanroep (RPC) tussen het huidige proces en WMI is mislukt.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Met deze functie wordt een aanroep van de methode IEnumWbemClassObject::Clone verpakt.

Met deze methode wordt alleen een 'best effort'-kopie uitgevoerd. Vanwege de dynamische aard van veel CIM-objecten is het mogelijk dat de nieuwe enumerator niet dezelfde set objecten opsommen als de bron-enumerator.

Als de functie-aanroep mislukt, kunt u aanvullende foutinformatie verkrijgen door de functie GetErrorInfo aan te roepen.

Voorbeeld

Zie de methode IEnumWbemClassObject::Clone voor een voorbeeld.

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)