Condividi tramite

Funzione BeginEnumeration

  • Articolo

Reimposta un enumeratore all'inizio dell'enumerazione.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

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

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

lEnumFlags
[in] Combinazione bit per bit dei flag o dei valori descritti nella sezione Osservazioni che controlla le proprietà incluse nell'enumerazione.

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_INVALID_PARAMETER 0x80041008 La combinazione di flag in lEnumFlags non è valida o è stato specificato un argomento non valido.
WBEM_E_UNEXPECTED 0x8004101d Una seconda chiamata a BeginEnumeration è stata effettuata senza una chiamata di intervento a EndEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Memoria insufficiente disponibile per avviare una nuova enumerazione.
WBEM_S_NO_ERROR 0 La chiamata alla funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::BeginEnumeration .

I flag che possono essere passati come lEnumFlags argomento sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice. È possibile combinare un flag da ogni gruppo con qualsiasi flag di qualsiasi altro gruppo. Tuttavia, i flag dello stesso gruppo si escludono a vicenda.

Gruppo 1

Costante Valore Descrizione
WBEM_FLAG_KEYS_ONLY 0x4 Includere le proprietà che costituiscono solo la chiave.
WBEM_FLAG_REFS_ONLY 0x8 Includere solo le proprietà di riferimento agli oggetti.

Gruppo 2

Costante Valore Descrizione
WBEM_FLAG_SYSTEM_ONLY 0x30 Limitare l'enumerazione solo alle proprietà di sistema.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Includere proprietà locali e propagate, ma escludere le proprietà di sistema dall'enumerazione.

Per le classi:

Costante Valore Descrizione
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Limitare l'enumerazione alle proprietà sottoposte a override nella definizione della classe.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Limitare l'enumerazione alle proprietà sottoposte a override nella definizione della classe corrente e alle nuove proprietà definite nella classe.
WBEM_MASK_CLASS_CONDITION 0x300 Maschera (anziché un flag) da applicare a un lEnumFlags valore per verificare se WBEM_FLAG_CLASS_OVERRIDES_ONLY o WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES è impostata.
WBEM_FLAG_LOCAL_ONLY 0x10 Limitare l'enumerazione alle proprietà definite o modificate nella classe stessa.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Limitare l'enumerazione alle proprietà ereditate dalle classi di base.

Per le istanze:

Costante Valore Descrizione
WBEM_FLAG_LOCAL_ONLY 0x10 Limitare l'enumerazione alle proprietà definite o modificate nella classe stessa.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Limitare l'enumerazione alle proprietà ereditate dalle classi di base.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche