WsReadXmlBufferFromBytes-Funktion (webservices.h)

  • Artikel

Verwendet einen Reader, um einen Satz codierter Bytes in eine WS_XML_BUFFER zu konvertieren.

Syntax

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] reader

Der Leser, der zum Analysieren der codierten Bytes verwendet werden soll.

[in, optional] encoding

Die Codierung, die beim Analysieren der Bytes verwendet werden soll. Bei NULL wird ein WS_XML_READER_TEXT_ENCODING mit dem Zeichensatz WS_CHARSET_AUTO verwendet.

properties

Ein Array optionaler Eigenschaften des Lesers. Siehe WS_XML_READER_PROPERTY.

[in] propertyCount

Die Anzahl der Eigenschaften.

bytes

Die zu analysierenden Bytes.

[in] byteCount

Die Anzahl der zu analysierenden Bytes.

[in] heap

Der Heap, aus dem der XML-Puffer zugeordnet werden soll.

xmlBuffer

Der XML-Puffer, in den die Bytes gelesen wurden, wird hier zurückgegeben.

[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

Die Funktion analysiert den gesamten Inhalt gemäß der angegebenen Codierung und speichert ihn in einer WS_XML_BUFFER.

Der Reader wird nach dem Aufrufen dieser Funktion in einem nicht definierten Zustand belassen. WsReadXmlBufferFromBytes kann jedoch mit einem solchen Reader erneut verwendet werden. Andernfalls sollte WsSetInput oder WsSetInputToBuffer verwendet werden, um den Leser wieder in einen bekannten Zustand zu versetzen, oder der Reader sollte mithilfe von WsFreeReader freigegeben werden.

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