WsWriteType-Funktion (webservices.h)

Artikel
08/27/2023

Schreiben Sie einen Wert eines angegebenen WS_TYPE gemäß der WS_TYPE_MAPPING in XML.

Syntax

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] writer

Der Writer, in den der Wert geschrieben werden soll.

[in] typeMapping

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

[in] type

Der Typ des zu serialisierenden Werts.

[in, optional] typeDescription

Zusätzliche Informationen zum Typ. Jeder Typ hat eine andere Beschreibungsstruktur. Dies kann je nach WS_TYPENULL sein.

[in] writeOption

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

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

value

Ein Zeiger auf den wert, der serialisiert werden soll.

[in] valueSize

Die Größe des werts, der serialisiert wird.

[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.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Informationen zum Schreiben von Werten in Elemente und Attribute finden Sie unter WS_TYPE_MAPPING .

Wenn die API fehlschlägt, wird der Status des Eingabeschreibers nicht definiert. Die einzigen APIs, die in diesem Fall für den Writer verwendet werden können, sind WsSetOutput und WsSetOutputToBuffer , um den Writer in einen verwendbaren Zustand zurückzugeben, oder WsFreeWriter , um den Writer 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

Freigeben über