Funzione QualifierSet_GetNames

Articolo
05/09/2023

Recupera i nomi di tutti i qualificatori o di determinati qualificatori disponibili dall'oggetto o dalla proprietà corrente.

Nota

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

Sintassi

HRESULT QualifierSet_GetNames (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] SAFEARRAY (BSTR)**  pstrNames
);

Parametri

vFunc
[in] Questo parametro è inutilizzato.

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

lFlags
[in] Uno dei flag o valori seguenti che specifica i nomi da includere nell'enumerazione.

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.

pstrNames
[out] Nuovo SAFEARRAY che contiene i nomi richiesti. La matrice può avere 0 elementi. Se si verifica un errore, un nuovo SAFEARRAY non viene restituito.

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	Un parametro non è valido.
`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::GetNames .

Dopo aver recuperato i nomi del qualificatore, è possibile accedere a ogni qualificatore chiamando la funzione QualifierSet_Get .

Non è un errore per un determinato oggetto per avere zero qualificatori, quindi il numero di stringhe in pstrNames su restituito può essere 0, anche se la funzione restituisce WBEM_S_NO_ERROR.

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