WsMoveWriter, fonction (webservices.h)

  • Article

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.

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.
WS_E_INVALID_FORMAT
 Les données d’entrée n’étaient pas au format attendu ou n’avaient pas la valeur attendue.

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

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