WsSetOutputToBuffer, fonction (webservices.h)

Article
08/27/2023

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

Partager via