WsWriteBytes-Funktion (webservices.h)

  • Artikel

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