Partager via

PutMethod, fonction

Crée une méthode.

Note

Cette API est destinée uniquement à une utilisation interne. Il n’est pas destiné à être utilisé à partir du code du développeur.

Syntaxe

HRESULT PutMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*  ptr,
   [in] LPCWSTR            wszName,
   [in] LONG               lFlags,
   [in] IWbemClassObject*  pInSignature,
   [in] IWbemClassObject*  pOutSignature
);

Paramètres

vFunc [in] Ce paramètre n’est pas utilisé.

ptr [in] Pointeur vers une instance IWbemClassObject .

wszName [in] Nom de la méthode à créer.

lFlags [in] Réservé. Ce paramètre doit être 0.

pSignatureIn [in] Pointeur vers une copie de la classe système __Parameters qui contient les in paramètres de la méthode. Ce paramètre est ignoré s’il est défini sur null.

pSignatureOut [in] Pointeur vers une copie de la classe système __Parameters qui contient les out paramètres de la méthode. Ce paramètre est ignoré s’il est défini sur null.

Valeur retournée

Les valeurs suivantes retournées par cette fonction sont définies dans le fichier d’en-tête WbemCli.h , ou vous pouvez les définir comme constantes dans votre code :

Constante Valeur Descriptif
WBEM_E_INVALID_PARAMETER 0x80041008 Un ou plusieurs paramètres ne sont pas valides.
WBEM_E_INVALID_DUPLICATE_PARAMETER 0x80041043 Le [in, out] paramètre de méthode spécifié dans les objets pInSignature et pOutSignature possèdent différents qualificateurs.
WBEM_E_MISSING_PARAMETER_ID 0x80041036 Un paramètre de méthode manque la spécification du ID qualificateur.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS 0x80041038 La série d’ID affectée aux paramètres de méthode n’est pas consécutive ou ne démarre pas à 0.
WBEM_E_PARAMETER_ID_ON_RETVAL 0x80041039 La valeur de retour d’une méthode a un ID qualificateur.
WBEM_E_PROPAGATED_METHOD 0x80041034 Une tentative a été effectuée pour réutiliser un nom de méthode existant à partir d’une classe parente et les signatures ne correspondent pas.
WBEM_S_NO_ERROR 0 L’appel de fonction a réussi.

Remarques

Cette fonction encapsule un appel à la méthode IWbemClassObject ::P utMethod .

Cet appel de méthode est pris en charge uniquement s’il ptr s’agit d’une définition de classe CIM. La manipulation de méthode n’est pas disponible à partir de pointeurs IWbemClassObject pointant vers des instances CIM.

Les utilisateurs ne peuvent pas créer de méthodes avec des noms qui commencent ou se terminent par un trait de soulignement. Ceci est réservé aux classes système et aux propriétés.

Pour une méthode, les in paramètres et out les propriétés sont décrits en tant que propriétés dans les objets IWbemClassObject .

Un [in/out] paramètre peut être défini en ajoutant la même propriété aux deux objets pointés par les paramètres et pOutSignature les pInSignature paramètres. Dans ce cas, les propriétés partagent la même ID valeur de qualificateur.

Chaque propriété d’un objet de classe __Parameters autre que ReturnValue doit avoir un ID qualificateur, une valeur numérique de base zéro qui identifie l’ordre dans lequel les paramètres apparaissent. Aucun paramètre ne peut avoir la même ID valeur et aucune valeur ne ID peut être ignorée. Si l’une ou l’autre condition se produit, la PutMethod fonction retourne WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Example

Pour obtenir un exemple, consultez la méthode IWbemClassObject ::P utMethod .

Spécifications

Plateformes : Consultez Configuration requise.

En-tête: WMINet_Utils.idl

Versions du .NET Framework : Disponible depuis la version 4.7.2

Voir aussi

  • Last updated on