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 |