Metodo IWbemQualifierSet::GetNames (wbemcli.h)

Il metodo IWbemQualifierSet::GetNames recupera i nomi di tutti i qualificatori disponibili dall'oggetto o dalla proprietà corrente. In alternativa, a seconda del valore del filtro di IFlags, questo metodo recupera i nomi di determinati qualificatori.

È possibile accedere a questi qualificatori in base al nome usando IWbemQualifierSet::Get per ogni nome. Non è un errore per qualsiasi oggetto specificato avere zero qualificatori, quindi il numero di stringhe in pstrNames su restituito può essere 0, anche se WBEM_S_NO_ERROR restituisce.

Sintassi

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parametri

[in] lFlags

Una delle costanti seguenti.

0 (Zero)

Restituisce i nomi di tutti i qualificatori.

WBEM_FLAG_LOCAL_ONLY

Restituisce solo i nomi dei qualificatori specifici della proprietà o dell'oggetto corrente. Se il set di qualificatori correnti fa riferimento a una proprietà, restituire solo i qualificatori specifici della proprietà (inclusi gli overridi) e non tali qualificatori propagati dalla definizione della classe. Se il set di qualificatori correnti fa riferimento a un'istanza, restituisce solo nomi di qualificatori specifici dell'istanza. Se il set di qualificatori correnti fa riferimento a una classe, restituisce solo qualificatori specifici della classe derivata.

WBEM_FLAG_PROPAGATED_ONLY

Restituisce solo i nomi dei qualificatori propagati da un altro oggetto. Ad esempio, se il set di qualificatori corrente fa riferimento a una proprietà, restituisce solo i qualificatori propagati a questa proprietà dalla definizione della classe e non a quelli della proprietà stessa. Se il set di qualificatori corrente fa riferimento a un'istanza, restituisce solo i qualificatori propagati dalla definizione della classe. Se il set di qualificatori corrente fa riferimento a una classe, restituisce solo i nomi dei qualificatori ereditati dalle classi padre.

[out] pNames

Viene creato un nuovo SAFEARRAY che contiene i nomi richiesti.

In tutti i casi in cui non viene restituito alcun errore, viene creata una nuova matrice e pstrNames è impostata su di esso. Ciò si verifica anche se la matrice risultante ha zero elementi. In caso di errore, non viene restituito un nuovo SAFEARRAY .

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

Commenti

Per un esempio di uso di SAFEARRAYs di BSTR, vedere Recupero della parte di un'istanza WMI.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)
Libreria	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Vedi anche

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get