WsMoveWriter, fonction (webservices.h)

Déplace la position actuelle de l’enregistreur comme spécifié par le paramètre moveTo.

Syntaxe

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Paramètres

[in] writer

Writer à déplacer.

[in] moveTo

Position relative pour déplacer l’enregistreur.

found

Si ce n’est pas NULL, la possibilité ou non de déplacer la nouvelle position vers est retournée ici.

Si cette valeur est NULL et que la position n’a pas pu être déplacée vers, la fonction retourne WS_E_INVALID_FORMAT. (Voir Valeurs de retour des services Web Windows.)

[in, optional] error

Spécifie l’emplacement où des informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction peut retourner l’une de ces valeurs.

Remarques

Cela ne peut être utilisé que sur un writer défini sur un WS_XML_BUFFER.

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.

Une fois positionné, l’enregistreur insère de nouvelles données avant la position spécifiée.

Configuration requise