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

Article
08/27/2023

La méthode IWbemContext::GetNames retourne une structure SAFEARRAY de tous les noms des valeurs de contexte nommées. Une fois tous les noms connus, GetValue peut être appelé sur chaque nom pour récupérer la valeur. Cette technique est un moyen d’accéder aux valeurs de contexte qui est différent de l’appel des méthodes BeginEnumeration, Next et EndEnumeration .

Syntaxe

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être 0.

[out] pNames

Ce paramètre ne peut pas être NULL, mais à l’entrée, il doit pointer vers NULL. Si aucune erreur n’est retournée, à la sortie pstrNames reçoit un pointeur vers une nouvelle structure SAFEARRAY de type VT_BSTR contenant tous les noms de valeurs de contexte. L’appelant doit appeler SafeArrayDestroy sur le pointeur retourné lorsque le tableau n’est plus nécessaire. Si un code d’erreur est retourné, le pointeur n’est pas modifié.

Note S’il n’y a pas de valeurs nommées dans l’objet, l’appel réussit et retourne un tableau de longueur 0.

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.

Remarques

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	Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

Voir aussi

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue

Partager via