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 |