WsSetOutputToBuffer-Funktion (webservices.h)

Artikel
03/06/2024

Dieser Vorgang positioniert den Writer am Ende des angegebenen Puffers.

Wenn für einen XML-Writer ein XML-Puffer als Ausgabe festgelegt ist, kann der Writer auf eine Weise des "zufälligen Zugriffs" verwendet werden, und die Funktionen WsGetWriterPosition, WsSetWriterPosition und WsMoveWriter können verwendet werden.

Die für diese Funktion angegebenen Eigenschaften überschreiben die mit der WsCreateWriter Funktion angegebenen Eigenschaften.

Hinweis Die Standardwerte der Eigenschaften des Writers finden Sie unter WsCreateWriter .

Syntax

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

Parameter

[in] writer

Ein Zeiger auf das WS_XML_WRITER-Objekt , für das die Ausgabe festgelegt ist. Der Zeiger muss auf ein gültiges XML Writer-Objekt verweisen.

[in] buffer

Ein Zeiger auf den Puffer, an den der Writer die Daten sendet.

properties

Ein WS_XML_WRITER_PROPERTY Zeiger, der auf ein "Array" von optionalen Writer-Eigenschaften verweist.

[in] propertyCount

Die Anzahl der Eigenschaften.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.

Hinweise

Die Standardwerte der Eigenschaften des Writers finden Sie unter WsCreateWriter .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über