Condividi tramite


Funzione QualifierSet_GetNames

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