IWbemClassObject ::NextMethod, méthode (wbemcli.h)

Article
03/03/2024

La méthode IWbemClassObject ::NextMethod est utilisée pour récupérer la méthode next dans une séquence d’énumération de méthode qui commence par un appel à IWbemClassObject ::BeginMethodEnumeration.

Cet appel est pris en charge uniquement si l’objet actuel 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.

Syntaxe

HRESULT NextMethod(
  [in]  long             lFlags,
  [out] BSTR             *pstrName,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Paramètres

[in] lFlags

Réservé. Ce paramètre doit être égal à 0 (zéro).

[out] pstrName

Pointeur qui doit pointer vers NULL avant l’appel. Ce paramètre reçoit l’adresse d’une valeur BSTR contenant le nom de la méthode. L’appelant doit libérer la chaîne à l’aide de SysFreeString quand elle n’est plus nécessaire.

[out] ppInSignature

Pointeur qui reçoit un pointeur vers un objet IWbemClassObject contenant les paramètres in pour la méthode .

[out] ppOutSignature

Pointeur qui reçoit un pointeur vers un IWbemClassObject contenant les paramètres de sortie de la méthode.

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. Pour connaître les valeurs HRESULT générales, consultez Codes d’erreur système.

Remarques

L’appelant commence la séquence d’énumération à l’aide de IWbemClassObject ::BeginMethodEnumeration, puis appelle IWbemClassObject ::NextMethod jusqu’à ce que WBEM_S_NO_MORE_DATA soit retourné. L’appelant, éventuellement, termine la séquence avec IWbemClassObject ::EndMethodEnumeration. L’appelant peut mettre fin à l’énumération tôt en appelant IWbemClassObject ::EndMethodEnumeration à tout moment.

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

Configuration requise

Condition requise	Valeur
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	CIMWin32.dll ; Esscli.dll ; Fastprox.dll ; FrameDyn.dll ; FrameDynOS.dll ; Krnlprov.dll ; Ncprov.dll ; Wbemcore.dll ; Wbemess.dll ; Wmipiprt.dll

Partager via