WsSetReaderPosition, fonction (webservices.h)

  • Article

Définit la position actuelle du lecteur. La position doit avoir été obtenue par un appel à WsGetReaderPosition ou WsGetWriterPosition.

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

Syntaxe

HRESULT WsSetReaderPosition(
  [in]           WS_XML_READER              *reader,
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

Paramètres

[in] reader

Pointeur vers l’objet WS_XML_READER pour lequel la position actuelle est définie. Le pointeur doit référencer un objet Lecteur XML valide.

[in] nodePosition

Pointeur vers la position à définir pour le lecteur.

[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_OPERATION
 L’opération n’est pas autorisée en raison de l’état actuel de l’objet.

Remarques

Pour plus d’informations sur l’utilisation des positions, consultez WS_XML_NODE_POSITION.

Cette fonction ne peut pas être utilisée lors de la canonisation. Si WsStartReaderCanonicalization a été appelé, il retourne WS_E_INVALID_OPERATION. (Voir Valeurs de retour des services Web Windows.)

Configuration requise

Condition requise Valeur
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