Funktionen CloneEnumWbemClassObject

Gör en logisk kopia av en uppräknare och behåller sin aktuella position i en uppräkning.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett att användas från utvecklarkod.

Syntax

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

Parametrar

ppEnum
[ut] Tar emot en pekare till en ny IEnumWbemClassObject.

authLevel
[in] Auktoriseringsnivån.

impLevel
[in] Personifieringsnivån.

pCurrentEnumWbemClassObject
[ut] En pekare till den IEnumWbemClassObject-instans som ska klonas.

strUser
[in] Användarnamnet. Mer information finns i funktionen ConnectServerWmi .

strPassword
[in] Lösenordet. Mer information finns i funktionen ConnectServerWmi .

strAuthority
[in] Användarens domännamn. Mer information finns i funktionen ConnectServerWmi .

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant	Värde	Beskrivning
WBEM_E_FAILED	0x80041001	Det har uppstått ett allmänt fel.
WBEM_E_INVALID_PARAMETER	0x80041008	En parameter är ogiltig.
WBEM_E_OUT_OF_MEMORY	0x80041006	Det finns inte tillräckligt med minne för att slutföra åtgärden.
WBEM_E_TRANSPORT_FAILURE	0x80041015	RPC-länken (Remote Procedure Call) mellan den aktuella processen och WMI misslyckades.
WBEM_S_NO_ERROR	0	Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till metoden IEnumWbemClassObject::Clone .

Den här metoden gör bara en "bästa ansträngning"-kopia. På grund av den dynamiska karaktären hos många CIM-objekt är det möjligt att den nya uppräknaren inte räknar upp samma uppsättning objekt som källuppräknaren.

Om funktionsanropet misslyckas kan du hämta ytterligare felinformation genom att anropa funktionen GetErrorInfo .

Exempel

Ett exempel finns i metoden IEnumWbemClassObject::Clone .

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

• WMI och prestandaräknare (ohanterad API-referens)