Méthode IWbemClassObject::GetNames (wbemcli.h)

La méthode IWbemClassObject::GetNames récupère les noms des propriétés dans l’objet . En outre, selon les critères de sélection fournis par l’utilisateur, il peut récupérer la totalité ou un sous-ensemble des propriétés. Ces propriétés sont ensuite accessibles à l’aide de IWbemClassObject::Get pour chaque nom. Cette méthode peut également retourner des propriétés système.

Syntaxe

HRESULT GetNames(
  [in]  LPCWSTR   wszQualifierName,
  [in]  long      lFlags,
  [in]  VARIANT   *pQualifierVal,
  [out] SAFEARRAY **pNames
);

Paramètres

[in] wszQualifierName

Paramètre qui peut être NULL. S’il n’est pas NULL, il doit pointer vers un LPCWSTR valide spécifiant un nom de qualificateur qui fonctionne dans le cadre d’un filtre. Cette opération est gérée en lecture seule. Pour plus d'informations, consultez la section Notes.

[in] lFlags

Pour plus d'informations, consultez la section Notes.

[in] pQualifierVal

Paramètre qui peut être NULL. Si ce n’est pas null, elle doit pointer vers une structure VARIANT valide initialisée vers une valeur de filtre. Ce VARIANT est géré en lecture seule par la méthode . Par conséquent, l’appelant doit appeler VariantClear sur celui-ci, si nécessaire. Pour plus d'informations, consultez la section Notes.

[out] pNames

Paramètre qui ne peut pas être NULL, mais à l’entrée, ce paramètre doit pointer vers NULL. Une nouvelle structure SAFEARRAY est toujours allouée et le pointeur est défini pour pointer vers celle-ci. Le tableau retourné peut avoir 0 élément, mais est toujours alloué quand WBEM_S_NO_ERROR retourne. En cas d’erreur, aucune nouvelle structure SAFEARRAY n’est retournée.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Remarques

Les noms retournés sont contrôlés par une combinaison d’indicateurs et de paramètres. Par exemple, tous les noms de toutes les propriétés peuvent être spécifiés, ou seules les propriétés de clé peuvent être spécifiées, et ainsi de suite. Le filtre principal est spécifié dans le paramètre lFlags ; les autres paramètres varient en fonction de celui-ci.

Les valeurs d’indicateur sont des champs de bits et peuvent être combinées. Un indicateur de chacun des groupes suivants peut être combiné avec un indicateur de chacun des autres groupes. Les valeurs d’indicateur au sein d’un groupe s’excluent mutuellement.

Indicateurs du groupe 1	Description
WBEM_FLAG_ALWAYS	Retourne tous les noms de propriétés. Les paramètres strQualifierName et pQualifierVal ne sont pas utilisés.
WBEM_FLAG_ONLY_IF_TRUE	Retourne uniquement les propriétés qui ont un qualificateur du nom spécifié par le paramètre strQualifierName. Si cet indicateur est utilisé, vous devez spécifier strQualifierName.
WBEM_FLAG_ONLY_IF_FALSE	Retourne uniquement les propriétés qui n’ont pas de qualificateur du nom spécifié par le paramètre strQualifierName. Si cet indicateur est utilisé, vous devez spécifier strQualifierName.
WBEM_FLAG_ONLY_IF_IDENTICAL	Retourne uniquement les propriétés qui ont un qualificateur du nom spécifié par le paramètre QualifierName et qui ont également une valeur identique à la valeur spécifiée par la structure VARIANT pointée vers pQualifierVal. Si cet indicateur est utilisé, vous devez spécifier QualifierName et pQualifierVal.

 

Indicateurs du groupe 2	Description
WBEM_FLAG_KEYS_ONLY	Retourne uniquement les noms de la ou des propriétés qui définissent les clés.
WBEM_FLAG_REFS_ONLY	Retourne uniquement les noms de propriétés qui sont des références d’objet.

 

Indicateurs du groupe 3	Description
WBEM_FLAG_LOCAL_ONLY	Retourne uniquement les noms de propriétés qui appartiennent à la classe la plus dérivée. Exclure les propriétés de la classe parente ou des classes parentes.
WBEM_FLAG_PROPAGATED_ONLY	Retourne uniquement les noms de propriétés qui appartiennent à la classe parente ou aux classes parentes.
WBEM_FLAG_SYSTEM_ONLY	Retourne uniquement les propriétés système.
WBEM_FLAG_NONSYSTEM_ONLY	Retourne uniquement les noms de propriétés qui ne sont pas des propriétés système.

 

Le renvoi d’une liste vide dans les cas où aucune propriété ne correspond aux filtres spécifiés n’est pas une erreur.

Pour plus d’informations sur l’utilisation des structures SAFEARRAY de valeurs BSTR , consultez Récupération d’une partie d’une instance WMI.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)
Bibliothèque	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Voir aussi

IWbemClassObject

IWbemClassObject::BeginEnumeration

IWbemClassObject::Get

WBEM_CONDITION_FLAG_TYPE

Propriétés du système WMI