WsReadType-Funktion (webservices.h)

  • Artikel

Liest einen Wert einer angegebenen WS_TYPE gemäß der WS_TYPE_MAPPING aus XML.

Syntax

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] reader

Der Reader, der auf dem XML-Code positioniert ist, der deserialisiert werden soll.

[in] typeMapping

Beschreibt, wie der Typ dem XML-Code zugeordnet wird, der gelesen wird.

[in] type

Der Typ des zu deserialisierenden Werts.

[in, optional] typeDescription

Zusätzliche Informationen zum Typ. Jeder Typ verfügt über eine andere Beschreibungsstruktur. Dies kann je nach WS_TYPENULL sein.

[in] readOption

Gibt an, ob der Wert erforderlich ist und wie der Wert zugeordnet wird. Weitere Informationen finden Sie unter WS_READ_OPTION .

Dieser Parameter muss über einen der folgenden Werte verfügen:

[in, optional] heap

Der Heap, in dem die deserialisierten Werte gespeichert werden sollen.

value

Die Interpretation dieses Parameters hängt vom WS_READ_OPTION ab.

[in] valueSize

Die Interpretation dieses Parameters hängt vom WS_READ_OPTION ab.

[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 hatten nicht das erwartete Format oder hatten nicht den erwarteten Wert.
E_OUTOFMEMORY
 Der Arbeitsspeicher ist nicht mehr vorhanden.
WS_E_QUOTA_EXCEEDED
 Das Größenkontingent des Heaps wurde überschritten.
E_INVALIDARG
 Mindestens ein Argument ist ungültig.

Hinweise

Informationen zur Verwendung dieser Funktion zum Lesen von Werten aus Elementen und Attributen finden Sie unter WS_TYPE_MAPPING .

Wenn die API fehlschlägt, wird der Status des Eingabelesers nicht definiert. Die einzigen APIs, die in diesem Fall für den Reader verwendet werden können, sind WsSetInput UndWsSetInputToBuffer , um den Reader in einen verwendbaren Zustand zurückzugeben, oder WsFreeReader , um den Reader freizugeben.

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