Funzione WsSetOutputToBuffer (webservices.h)

Articolo
08/27/2023

Questa operazione posiziona il writer alla fine del buffer specificato.

Quando un writer XML dispone di un set di buffer XML come output, è possibile usare writer in modo "accesso casuale" e le funzioni WsGetWriterPosition, WsSetWriterPosition e WsMoveWriterWriter possono essere usate.

Le proprietà specificate per questa funzione eseguono l'override di quelle specificate con la WsCreateWriter funzione.

Nota Vedere WsCreateWriter per i valori predefiniti delle proprietà del writer.

Sintassi

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
);

Parametri

[in] writer

Puntatore all'oggetto WS_XML_WRITER per cui è impostato l'output. Il puntatore deve fare riferimento a un oggetto Writer XML valido.

[in] buffer

Puntatore al buffer in cui il writer invia i dati.

properties

Puntatore WS_XML_WRITER_PROPERTY che fa riferimento a una "matrice" di proprietà facoltative Writer.

[in] propertyCount

Numero di proprietà.

[in, optional] error

Puntatore a un oggetto WS_ERROR in cui devono essere archiviate informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
E_INVALIDARG	Uno o più argomenti non sono validi.

Commenti

Vedere WsCreateWriter per i valori predefiniti delle proprietà del writer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite