WS_WRITE_OPTION-Enumeration (webservices.h)

  • Artikel

Gibt an, ob ein angegebener Speicher den Wert oder einen Zeiger auf den Wert enthält und ob der Wert im XML-Inhalt als null dargestellt werden kann.

Syntax

typedef enum {
  WS_WRITE_REQUIRED_VALUE = 1,
  WS_WRITE_REQUIRED_POINTER = 2,
  WS_WRITE_NILLABLE_VALUE = 3,
  WS_WRITE_NILLABLE_POINTER = 4
} WS_WRITE_OPTION;

Konstanten

 
WS_WRITE_REQUIRED_VALUE
Wert: 1
Der angegebene Speicher enthält den Wert. Die Größe des Speichers
angegeben sollte die Größe des Werts sein.


Diese Option gibt an, dass der Wert immer in den XML-Inhalt geschrieben wird.



syntax<br>int value;<br>Api(..., &amp;value, sizeof(value), ...);<br>


syntax<br>// always written<br>&lt;element&gt;123&lt;/element&gt;<br>

Diese Option wird für Zeigertypen nicht unterstützt.
(WS_WSZ_TYPE und WS_XML_BUFFER_TYPE).
Die Option WS_WRITE_REQUIRED_POINTER sollte für diese Typen verwendet werden.
WS_WRITE_REQUIRED_POINTER
Wert: 2
Der angegebene Speicher enthält einen Zeiger auf den Wert. The
Die Größe des angegebenen Speichers entspricht immer der Größe eines Zeigers, unabhängig davon
des Typs, der serialisiert wird.


Diese Option gibt an, dass der Wert immer in den XML-Inhalt geschrieben wird.



syntax<br>int* valuePointer; // may not be NULL<br>Api(..., &amp;valuePointer, sizeof(valuePointer), ...);<br>


syntax<br>// always written<br>&lt;element&gt;123&lt;/element&gt;<br>

Wenn der Zeiger auf den im Speicher angegebenen Wert NULL ist,
E_INVALIDARG wird zurückgegeben.
(Siehe Rückgabewerte für Windows-Webdienste.)
WS_WRITE_NILLABLE_VALUE
Wert: 3
Der angegebene Speicher enthält einen Zeiger auf den Wert. The
Die Größe des angegebenen Speichers entspricht immer der Größe eines Zeigers, unabhängig davon
des Typs, der serialisiert wird.


Wenn der Wert null ist, wird ein nil-Element in den XML-Inhalt geschrieben.
Wenn kein Nullwert ist, wird der Wert normal serialisiert.



syntax<br>WS_STRING value; // may contain a nil value (see WS_STRING_TYPE)<br>Api(..., &amp;value, sizeof(value), ...);<br>


syntax<br>// if value is non-nil<br>&lt;element&gt;hello&lt;/element&gt;<br><br>// if value is nil<br>&lt;element xsi:nil='true'/&gt;<br>

Diese Option wird nur für die unten aufgeführten Typen unterstützt:
die über eine systeminterne Darstellung eines Nullwerts verfügen. Weitere Informationen finden Sie in der Dokumentation.
für jeden Typ, um Informationen darüber zu finden, wie null dargestellt wird.
WS_WRITE_NILLABLE_POINTER
Wert: 4
Für alle Typen enthält der angegebene Speicher einen Zeiger auf den Wert. The
Die Größe des angegebenen Speichers entspricht immer der Größe eines Zeigers, unabhängig davon
des Typs, der serialisiert wird.


Wenn der Zeiger auf den im Speicher angegebenen Wert NULL ist, dann
ein nil-Element wird in den XML-Inhalt geschrieben.



syntax<br>int* valuePointer; // may be NULL<br>Api(..., &amp;valuePointer, sizeof(valuePointer), ...);<br><br>


syntax<br>// if value is non-NULL<br>&lt;element&gt;123&lt;/element&gt;<br><br>// if value is NULL<br>&lt;element xsi:nil='true'/&gt;<br>

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile webservices.h