Metodo IWbemClassObject::GetNames (wbemcli.h)
Il metodo IWbemClassObject::GetNames recupera i nomi delle proprietà nell'oggetto. Inoltre, a seconda dei criteri di selezione forniti dall'utente, può recuperare tutti o un subset delle proprietà. Queste proprietà possono quindi essere accessibili usando IWbemClassObject::Get per ogni nome. Questo metodo può anche restituire le proprietà di sistema.
Sintassi
HRESULT GetNames(
[in] LPCWSTR wszQualifierName,
[in] long lFlags,
[in] VARIANT *pQualifierVal,
[out] SAFEARRAY **pNames
);
Parametri
[in] wszQualifierName
Parametro che può essere NULL. Se non NULL, deve puntare a un LPCWSTR valido specificando un nome qualificatore che opera come parte di un filtro. Questa operazione viene gestita come di sola lettura. Per altre informazioni, vedere la sezione Osservazioni.
[in] lFlags
Per altre informazioni, vedere la sezione Osservazioni.
[in] pQualifierVal
Parametro che può essere NULL. In caso contrario , deve puntare a una struttura VARIANT valida inizializzata in un valore di filtro. Questo VALORE VARIANT viene gestito come di sola lettura dal metodo . Pertanto, il chiamante deve chiamare VariantClear su di esso, se necessario. Per altre informazioni, vedere la sezione Osservazioni.
[out] pNames
Parametro che non può essere NULL, ma nella voce questo parametro deve puntare a NULL. Una nuova struttura SAFEARRAY viene sempre allocata e il puntatore è impostato su di esso. La matrice restituita può avere 0 elementi, ma viene sempre allocata quando WBEM_S_NO_ERROR restituisce. In caso di errore, non viene restituita una nuova struttura 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. Per i valori HRESULT generali, vedere Codici di errore di sistema.
Commenti
I nomi restituiti sono controllati da una combinazione di flag e parametri. Ad esempio, è possibile specificare tutti i nomi di tutte le proprietà oppure specificare solo le proprietà della chiave e così via. Il filtro primario viene specificato nel parametro lFlags ; gli altri parametri variano a seconda di esso.
I valori del flag sono campi bit e possono essere combinati. Un flag di ognuno dei gruppi seguenti può essere combinato con un flag da ognuno degli altri gruppi. I valori di flag all'interno di un gruppo si escludono a vicenda.
| Flag gruppo 1 | Descrizione |
|---|---|
| WBEM_FLAG_ALWAYS | Restituisce tutti i nomi delle proprietà. I parametri strQualifierName e pQualifierVal non vengono usati. |
| WBEM_FLAG_ONLY_IF_TRUE | Restituisce solo le proprietà che hanno un qualificatore del nome specificato dal parametro strQualifierName. Se questo flag viene usato, è necessario specificare strQualifierName. |
| WBEM_FLAG_ONLY_IF_FALSE | Restituisce solo le proprietà che non hanno un qualificatore del nome specificato dal parametro strQualifierName. Se questo flag viene usato, è necessario specificare strQualifierName. |
| WBEM_FLAG_ONLY_IF_IDENTICAL | Restituisce solo le proprietà che hanno un qualificatore del nome specificato dal parametro QualifierName e hanno anche un valore identico al valore specificato dalla struttura VARIANT a cui fa riferimento pQualifierVal. Se questo flag viene usato, è necessario specificare sia QualifierName che pQualifierVal. |
| Flag gruppo 2 | Descrizione |
|---|---|
| WBEM_FLAG_KEYS_ONLY | Restituisce solo i nomi della proprietà o delle proprietà che definiscono le chiavi. |
| WBEM_FLAG_REFS_ONLY | Restituisce solo nomi di proprietà che sono riferimenti a oggetti. |
| Flag di gruppo 3 | Descrizione |
|---|---|
| WBEM_FLAG_LOCAL_ONLY | Restituisce solo nomi di proprietà appartenenti alla classe più derivata. Escludere le proprietà dalla classe padre o dalle classi padre. |
| WBEM_FLAG_PROPAGATED_ONLY | Restituisce solo nomi di proprietà appartenenti alla classe padre o alle classi padre. |
| WBEM_FLAG_SYSTEM_ONLY | Restituisce solo le proprietà di sistema. |
| WBEM_FLAG_NONSYSTEM_ONLY | Restituisce solo nomi di proprietà che non sono proprietà di sistema. |
Non è un errore per restituire un elenco vuoto nei casi in cui nessuna proprietà corrisponda ai filtri specificati.
Per altre informazioni sull'uso di strutture SAFEARRAY di valori BSTR , vedere Recupero di parte di un'istanza WMI.
Requisiti
| 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 | CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll |