NextMethod, fonction
Récupère la méthode suivante dans une énumération qui commence par un appel à BeginMethodEnumeration.
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 NextMethod (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LONG lFlags,
[out] BSTR* pName,
[out] IWbemClassObject** ppInSignature,
[out] IWbemClassObject** ppOutSignature
);
Paramètres
vFunc
[in] Ce paramètre est inutilisé.
ptr
[in] Pointeur vers une instance IWbemClassObject.
lFlags
[in] Réservée. Ce paramètre doit être 0.
pName
[out] Pointeur pointant vers null avant l’appel. Lorsque la fonction retourne, adresse d’un nouveau BSTR contenant le nom de la méthode.
ppSignatureIn
[out] Pointeur qui reçoit un pointeur vers un IWbemClassObject contenant les paramètres in de la méthode.
ppSignatureOut
[out] Pointeur qui reçoit un pointeur vers un IWbemClassObject contenant les paramètres out de la méthode.
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_UNEXPECTED |
0x8004101d | Il n’y a pas eu d’appel à la fonction BeginEnumeration. |
WBEM_S_NO_ERROR |
0 | L’appel de fonction a réussi. |
WBEM_S_NO_MORE_DATA |
0x40005 | Il n’y a plus de propriétés dans l’énumération. |
Notes
Cette fonction encapsule un appel à la méthode IWbemClassObject::NextMethod.
L’appelant commence la séquence d’énumération en appelant la fonction BeginMethodEnumeration, puis appelle la fonction [NextMethod] jusqu’à ce que la fonction retourne WBEM_S_NO_MORE_DATA. Éventuellement, l’appelant termine la séquence en appelant la fonction EndMethodEnumeration. L’appelant peut arrêter l’énumération à tout moment en appelant la fonction EndMethodEnumeration.
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
