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

  • Article

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