WsReadXmlBufferFromBytes-Funktion (webservices.h)
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 |
---|---|
|
Mindestens ein Argument ist ungültig. |
|
Der Vorgang ist aufgrund des aktuellen Zustands des Objekts nicht zulässig. |
|
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 |