WsSetReaderPosition, fonction (webservices.h)

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.

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