Funzione QualifierSet_BeginEnumeration

Articolo
05/10/2023

Reimposta un enumeratore dei qualificatori di un oggetto all'inizio dell'enumerazione.

Nota

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

Sintassi

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parametri

vFunc
[in] Questo parametro è inutilizzato.

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

lFlags
[in] Combinazione bit per bit dei flag o dei valori descritti nella sezione Osservazioni che specifica i qualificatori da includere 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	Il parametro `lFlags` non è valido.
`WBEM_E_UNEXPECTED`	0x8004101d	Una seconda chiamata a `QualifierSet_BeginEnumeration` è stata effettuata senza una chiamata di intervento a `QualifierSet_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 IWbemQualifierSet::BeginEnumeration .

Per enumerare tutti i qualificatori in un oggetto, questo metodo deve essere chiamato prima della prima chiamata a QualifierSet_Next. L'ordine in cui vengono enumerati i qualificatori è garantito che sia invariante per un'enumerazione specificata.

I flag che possono essere passati come lEnumFlags argomento sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice.

Costante	Valore	Descrizione
	0	Restituisce i nomi di tutti i qualificatori.
`WBEM_FLAG_LOCAL_ONLY`	0x10	Restituisce solo i nomi dei qualificatori specifici della proprietà o dell'oggetto corrente. Per una proprietà: restituire solo i qualificatori specifici della proprietà (inclusi gli overridi) e non tali qualificatori propagati dalla definizione della classe. Per un'istanza: restituisce solo nomi di qualificatori specifici dell'istanza. Per una classe: restituisce solo qualificatori specifici della classe derivata.
`WBEM_FLAG_PROPAGATED_ONLY`	0x20	Restituisce solo i nomi dei qualificatori propagati da un altro oggetto. Per una proprietà: restituire solo i qualificatori propagati a questa proprietà dalla definizione della classe e non quelli dalla proprietà stessa. Per un'istanza: restituire solo i qualificatori propagati dalla definizione della classe. Per una classe: restituisce solo i nomi dei qualificatori ereditati dalle classi padre.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite