WsReadArray-Funktion (webservices.h)

Artikel
08/27/2023

Liest eine Reihe von Elementen aus dem Reader und interpretiert ihren Inhalt entsprechend dem angegebenen Werttyp.

Syntax

HRESULT WsReadArray(
  [in]           WS_XML_READER       *reader,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in]           WS_VALUE_TYPE       valueType,
                 void                *array,
  [in]           ULONG               arraySize,
  [in]           ULONG               itemOffset,
  [in]           ULONG               itemCount,
  [out]          ULONG               *actualItemCount,
  [in, optional] WS_ERROR            *error
);

Parameter

[in] reader

Der Leser, aus dem das Array gelesen werden soll.

[in] localName

Der localName des sich wiederholenden Elements.

[in] ns

Der Namespace des sich wiederholenden Elements.

[in] valueType

Der Werttyp, der zum Analysieren des Inhalts der einzelnen Elemente verwendet werden soll.

array

Das Array, das mit analysierten Werten aufgefüllt werden soll. Die Größe der Arrayelemente wird durch den Werttyp bestimmt. Weitere Informationen finden Sie unter WS_VALUE_TYPE .

[in] arraySize

Die Größe des Arrays in Bytes (nicht Elemente).

[in] itemOffset

Der Elementoffset (nicht byte) innerhalb des Arrays, an dem gelesen werden soll.

[in] itemCount

Die Anzahl der Elemente (nicht Bytes), die in das Array eingelesen werden sollen.

[out] actualItemCount

Die tatsächliche Anzahl der gelesenen Elemente. Dies kann kleiner als itemCount sein, auch wenn mehr Elemente übrig sind. Es gibt keine weiteren Elemente, wenn dies null zurückgibt.

[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
WS_E_INVALID_FORMAT	Die Eingabedaten waren nicht im erwarteten Format oder hatten nicht den erwarteten Wert.
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.

Hinweise

Diese Funktion entspricht semantisch der Verwendung von WsReadStartElement, WsReadValue und WsReadEndElement in einer Schleife, ist aber effizienter.

Diese Funktion kann aus einem der in WsReadNode aufgeführten Gründe fehlschlagen.

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