Partager via


WsSetOutputToBuffer, fonction (webservices.h)

Cette opération positionne l’enregistreur à la fin de la mémoire tampon spécifiée.

Lorsqu’un enregistreur XML a un ensemble de mémoires tampons XML en tant que sortie, l’enregistreur peut être utilisé en mode « accès aléatoire » et les fonctions WsGetWriterPosition, WsSetWriterPosition et WsMoveWriter peuvent être utilisées.

Les propriétés spécifiées pour cette fonction remplacent celles spécifiées avec la WsCreateWriter fonction .

Note Consultez WsCreateWriter pour connaître les valeurs par défaut des propriétés de l’enregistreur.

 

Syntaxe

HRESULT WsSetOutputToBuffer(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *buffer,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

Paramètres

[in] writer

Pointeur vers l’objet WS_XML_WRITER pour lequel la sortie est définie. Le pointeur doit référencer un objet Writer XML valide.

[in] buffer

Pointeur vers la mémoire tampon où l’enregistreur envoie les données.

properties

Pointeur WS_XML_WRITER_PROPERTY qui fait référence à un « tableau » de propriétés writer facultatives.

[in] propertyCount

Nombre de propriétés.

[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.

Remarques

Consultez WsCreateWriter pour connaître les valeurs par défaut des propriétés de l’enregistreur.

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