WsSetOutput-Funktion (webservices.h)

Artikel
08/27/2023

Legt die Codierungs- und Ausgaberückrufe für den Writer fest. Die Rückrufe werden verwendet, um Puffer für den Writer zur Verfügung zu stellen und asynchrone E/A-Vorgänge auszuführen.

Syntax

HRESULT WsSetOutput(
  [in]           WS_XML_WRITER                *writer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
  [in, optional] const WS_XML_WRITER_OUTPUT   *output,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] writer

Der Writer, für den die Ausgabe festgelegt wird.

[in, optional] encoding

Die Codierung beschreibt das Format der Eingabebytes. Dies sollte eine der WS_XML_WRITER_TEXT_ENCODING, WS_XML_WRITER_BINARY_ENCODING oder WS_XML_WRITER_MTOM_ENCODING sein.

[in, optional] output

Gibt an, wo der Writer seine Daten platzieren soll.

properties

Ein Array optionaler Eigenschaften des Writers. Siehe WS_XML_WRITER_PROPERTY.

[in] propertyCount

Die Anzahl der Eigenschaften.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen 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

Wenn WsSetOutput für den Writer verwendet wird, funktioniert der Writer nur vorwärts, und die Funktionen WsGetWriterPosition, WsSetWriterPosition und WsMoveWriter können nicht verwendet werden.

Wenn die CodierungNULL ist, wird WS_XML_WRITER_OUTPUT ignoriert, und der Writer ist so eingerichtet, dass jeder Schreibversuch fehlschlägt.

Wenn die Codierung nicht NULL ist, muss auch WS_XML_WRITER_OUTPUT nicht NULL sein.

Wenn WS_XML_WRITER_OUTPUT WS_XML_WRITER_BUFFER_OUTPUT ist, puffert der Writer die generierten Bytes des Dokuments. Verwenden Sie WsGetWriterProperty mit WS_XML_WRITER_PROPERTY_BUFFERS oder WS_XML_WRITER_PROPERTY_BYTES , um diese Bytes abzurufen. In diesem Modus hat WsFlushWriter keine Auswirkung.

Wenn WS_XML_WRITER_OUTPUT WS_XML_WRITER_STREAM_OUTPUT ist, übergibt der Writer die generierten Bytes des Dokuments während der Aufrufe von WsFlushWriter an die angegebene WS_WRITE_CALLBACK.

Der Writer wird initialisiert, um die in WsCreateWriter angegebenen Eigenschaften zu verwenden. Alle für WsSetOutput angegebenen Eigenschaften überschreiben diese Eigenschaften.

Die Standardwerte der Eigenschaften des Writers finden Sie unter WsCreateWriter .

Anforderungen


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