Dela via

Funktionen BeginEnumeration

Återställer en uppräkning tillbaka till början av uppräkningen.

Anteckning

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

Syntax

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parametrar

vFunc
[i] Den här parametern används inte.

ptr
[i] En pekare till en IWbemClassObject-instans .

lEnumFlags
[i] En bitvis kombination av flaggorna eller värdena som beskrivs i avsnittet Kommentarer som styr egenskaperna som ingår i uppräkningen.

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_INVALID_PARAMETER 0x80041008 Kombinationen av flaggor i lEnumFlags är ogiltig eller så har ett ogiltigt argument angetts.
WBEM_E_UNEXPECTED 0x8004101d Ett andra anrop till BeginEnumeration gjordes utan ett mellanliggande anrop till EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Det finns inte tillräckligt med minne för att påbörja en ny uppräkning.
WBEM_S_NO_ERROR 0 Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till IWbemClassObject::BeginEnumeration-metoden .

Flaggorna som kan skickas som lEnumFlags argumentet definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden. Du kan kombinera en flagga från varje grupp med valfri flagga från valfri annan grupp. Flaggor från samma grupp utesluter dock varandra.

Grupp 1

Konstant Värde Beskrivning
WBEM_FLAG_KEYS_ONLY 0x4 Inkludera egenskaper som endast utgör nyckeln.
WBEM_FLAG_REFS_ONLY 0x8 Inkludera egenskaper som endast är objektreferenser.

Grupp 2

Konstant Värde Beskrivning
WBEM_FLAG_SYSTEM_ONLY 0x30 Begränsa uppräkningen till endast systemegenskaper.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Inkludera lokala och spridda egenskaper men exkludera systemegenskaper från uppräkningen.

För klasser:

Konstant Värde Beskrivning
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Begränsa uppräkningen till egenskaper som åsidosättas i klassdefinitionen.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Begränsa uppräkningen till egenskaper som åsidosatts i den aktuella klassdefinitionen och till nya egenskaper som definierats i klassen.
WBEM_MASK_CLASS_CONDITION 0x300 En mask (i stället för en flagga) som ska tillämpas mot ett lEnumFlags värde för att kontrollera om antingen WBEM_FLAG_CLASS_OVERRIDES_ONLY eller WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES har angetts.
WBEM_FLAG_LOCAL_ONLY 0x10 Begränsa uppräkningen till egenskaper som definieras eller ändras i själva klassen.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Begränsa uppräkningen till egenskaper som ärvs från basklasser.

För instanser:

Konstant Värde Beskrivning
WBEM_FLAG_LOCAL_ONLY 0x10 Begränsa uppräkningen till egenskaper som definieras eller ändras i själva klassen.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Begränsa uppräkningen till egenskaper som ärvs från basklasser.

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

  • Last updated on