WsMoveReader, fonction (webservices.h)

Article
08/27/2023

Déplace la position actuelle du lecteur comme spécifié par le paramètre moveTo .

Cette fonction ne peut être utilisée que sur un lecteur défini sur xmlBuffer.

Syntaxe

HRESULT WsMoveReader(
  [in]           WS_XML_READER *reader,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] reader

Pointeur vers l’objet Lecteur XML avec la position à déplacer. Le pointeur doit référencer un objet WS_XML_READER valide et la valeur Reader référencée peut ne pas être NULL.

[in] moveTo

Cet énumérateur spécifie la direction ou la position suivante du lecteur par rapport à la position actuelle.

found

Indique la réussite ou l’échec du déplacement spécifié.

[in, optional] error

Pointeur vers un objet WS_ERROR où des informations supplémentaires sur l’erreur doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Code de retour	Description
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
WS_E_INVALID_FORMAT	Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.
WS_E_INVALID_OPERATION	L’opération n’est pas autorisée en raison de l’état actuel de l’objet.

Remarques

Si le paramètre trouvé n’est pas NULL, il indique s’il peut ou non se déplacer vers le nœud demandé et retourner NOERROR.

Si le paramètre trouvé est NULL et que le nœud demandé est introuvable, il retourne WS_E_INVALID_FORMAT. (Voir Valeurs de retour des services Web Windows.)

Cette fonction ne peut pas être utilisée lors de la canonisation. Si WsStartReaderCanonicalization a été appelé, il retourne WS_E_INVALID_OPERATION.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll