WsWriteBytes-Funktion (webservices.h)

Artikel
08/27/2023

Schreibt Bytes in ein für die Codierung optimiertes Format in den Writer. Beim Schreiben in einer Textcodierung werden die bytes ausgegeben, die in base64 codiert sind. Beim Schreiben in ein Binärformat werden die Bytes direkt ausgegeben.

Syntax

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Der Writer, in den die Bytes geschrieben werden.

bytes

Die Bytes, die in das Dokument geschrieben werden sollen.

[in] byteCount

Die Anzahl bytes, die in das Dokument geschrieben werden sollen.

[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.
WS_E_INVALID_OPERATION	Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.

Hinweise

WsWriteBytes kann zwischen WsWriteStartAttribute und WsWriteEndAttribute mehrmals aufgerufen werden. Sie kann beim Schreiben eines Attributs nicht mit WsWriteChars, WsWriteCharsUtf8, WsWriteValue oder WsWriteText kombiniert werden.

Wenn der byteCount für die WS_XML_WRITER_MTOM_ENCODING den während WsSetOutput angegebenen maxInlineByteCount überschreitet, werden die Bytes gepuffert und in ihrem eigenen MIME-Teil platziert. Andernfalls werden die Bytes in base64 codiert und direkt im Dokument platziert.

Wenn das Element, das die Bytes enthält, für die WS_XML_WRITER_MTOM_ENCODING über ein Attribut mit dem Namen "contentType" und dem Namespace ""http://www.w3.org/2004/11/xmlmime verfügt, wird der Wert des Attributs im Inhaltstypheader für den MIME-Teil widergespiegelt, wie in optimierter XML-binärverpackung beschrieben.

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