WsReadType-Funktion (webservices.h)

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:

• WS_READ_REQUIRED_VALUE.
• WS_READ_REQUIRED_POINTER.

[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.

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