WsMoveReader, fonction (webservices.h)

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.

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