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

Vedi anche

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::Get

WBEM_CONDITION_FLAG_TYPE

Proprietà del sistema WMI