PutMethod, fonction
Crée une méthode.
Notes
Cette API est destinée à un usage interne uniquement. Elle n’est pas destinée à être utilisée dans le 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 est inutilisé.
ptr
[in] Pointeur vers une instance IWbemClassObject.
wszName
[in] Nom de la méthode à créer.
lFlags
[in] Réservée. Ce paramètre doit être 0.
pSignatureIn
[in] Pointeur vers une copie de la classe système __Parameters qui contient les paramètres in de la méthode. Ce paramètre est ignoré s’il a la valeur null.
pSignatureOut
[in] Pointeur vers une copie de la classe système __Parameters qui contient les paramètres out de la méthode. Ce paramètre est ignoré s’il a la valeur null.
Valeur retournée
Les valeurs suivantes renvoyé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 :
| Constant | Valeur | Description |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | Un ou plusieurs paramètres ne sont pas valides. |
WBEM_E_INVALID_DUPLICATE_PARAMETER |
0x80041043 | Le paramètre [in, out] de méthode spécifié dans les objets pInSignature et pOutSignature a des qualificateurs différents. |
WBEM_E_MISSING_PARAMETER_ID |
0x80041036 | Un paramètre de méthode n’a pas la spécification du qualificateur d’ID. |
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 pour une méthode a un qualificateur ID. |
WBEM_E_PROPAGATED_METHOD |
0x80041034 | Une tentative a été effectuée pour réutiliser un nom de méthode existant d’une classe parente et les signatures ne concordent pas. |
WBEM_S_NO_ERROR |
0 | L’appel de fonction a abouti. |
Notes
Cette fonction encapsule un appel à la méthode IWbemClassObject::PutMethod.
Cet appel de méthode est pris en charge uniquement si ptr est une définition de classe CIM. La manipulation de méthode n’est pas disponible à partir des pointeurs IWbemClassObject qui pointent 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. Cela est réservé aux classes et aux propriétés système.
Pour une méthode, les paramètres in et out sont décrits sous forme de propriétés dans des objets IWbemClassObject.
Un paramètre [in/out] peut être défini en ajoutant la même propriété aux deux objets pointés par les paramètres pInSignature et pOutSignature. Dans ce cas, les propriétés partagent la même valeur de qualificateur d’ID.
Chaque propriété d’un objet de classe __Parameters autre que ReturnValue doit avoir un qualificateur d’ID, 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 valeur d’ID et aucune valeur d’ID ne peut être ignorée. Si l’une ou l’autre condition se produit, la fonction PutMethod retourne WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.
Exemple
Pour obtenir un exemple, consultez la méthode IWbemClassObject::PutMethod.
Spécifications
Plateformes : Consultez Configuration requise.
En-tête : WMINet_Utils.idl
Versions de .NET Framework : disponibles depuis la version 4.7.2
