WsWriteArray-Funktion (webservices.h)

Artikel
03/03/2024

Dieser Vorgang sendet eine Reihe von Elementen an einen XML Writer.

Syntax

HRESULT WsWriteArray(
  [in]           WS_XML_WRITER       *writer,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 const void          *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] writer

Ein Zeiger auf den Writer, in dem die Elemente geschrieben werden.

[in] localName

Ein Zeiger auf den localName des sich wiederholenden Elements.

[in] ns

Ein Zeiger auf den Namespace des sich wiederholenden Elements.

[in] valueType

Der Werttyp für die Elemente

array

Ein Void-Zeiger auf die Werte, die in writer geschrieben wurden. Die Größe der Elemente wird durch den Werttyp bestimmt.

Hinweis Weitere Informationen finden Sie unter WS_VALUE_TYPE .

[in] arraySize

Die Gesamtbytelänge des Arrays.

[in] itemOffset

Der Elementoffset innerhalb des zu schreibenden Arrays.

[in] itemCount

Die Gesamtanzahl der Elemente, die aus dem Array geschrieben werden sollen.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion entspricht semantisch der Verwendung von WsWriteStartElement, WsWriteValue und WsWriteEndElement in einer Schleife, ist aber effizienter.

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