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

  • Article

La méthode IWbemClassObject::GetMethod retourne des informations sur la méthode demandée. Cet appel n’est pris en charge que si l’objet actuel est une définition de classe CIM. Les informations sur la méthode ne sont pas disponibles à partir des pointeurs IWbemClassObject qui pointent vers des instances CIM.

Syntaxe

HRESULT GetMethod(
  [in]  LPCWSTR          wszName,
  [in]  long             lFlags,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Paramètres

[in] wszName

Nom de la méthode. Cela ne peut pas être NULL et doit pointer vers une LPCWSTR valide.

[in] lFlags

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

[out] ppInSignature

Pointeur qui reçoit un pointeur IWbemClassObject qui décrit les paramètres dans à la méthode . Ce paramètre est ignoré s’il est défini sur NULL. N’oubliez pas que Gestion Windows peut définir le pointeur IWbemClassObject sur NULL si cette méthode n’a aucun paramètre dans. Pour plus d'informations, consultez la section Notes.

[out] ppOutSignature

Pointeur qui reçoit un pointeur IWbemClassObject qui décrit les paramètres de sortie de la méthode. Ce paramètre sera ignoré s’il est défini sur NULL.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique l’état 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

Pour une méthode, les paramètres d’entrée et de sortie sont décrits en tant que propriétés dans un IWbemClassObject, un instance de la classe système __Parameters.

Par exemple, considérez la méthode suivante :

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Parm1, [in] uint32 Parm2, 
      [out] string Parm3);
};

Dans cet exemple, la classe a une seule méthode. Lorsque l’utilisateur appelle IWbemClassObject::GetMethod, le paramètre ppInSignature reçoit un objet IWbemClassObject , qui contient deux propriétés : Parm1 et Parm2. Le paramètre ppOutSignature contient deux propriétés, Parm3 et ReturnValue.

Après avoir renseigné les valeurs de propriété de l’objet ppInSignature , l’appelant peut utiliser l’objet pour exécuter la méthode en appelant IWbemServices::ExecMethod ou IWbemServices::ExecMethodAsync.

Note L’appelant doit appeler IWbemClassObject::Release sur les pointeurs ppInSignature et ppOutSignature lorsque ces objets ne sont plus nécessaires.
 

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 (inclure 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::P utMethod