Freigeben über

WS_WRITE_OPTION-Aufzählung (webservices.h)

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.


int-Wert;
Api(..., &value, sizeof(value), ...);



immer geschrieben

              <Element>123</Element>


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. Das
Die größe des angegebenen Speichers ist unabhängig von der Größe eines Zeigers immer die Größe eines Zeigers.
des Typs, der serialisiert wird.

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


int* valuePointer; darf nicht NULL sein
Api(..., &valuePointer, sizeof(valuePointer), ...);



immer geschrieben

              <Element>123</Element>


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. Das
Die größe des angegebenen Speichers ist unabhängig von der Größe eines Zeigers immer die Größe eines Zeigers.
des Typs, der serialisiert wird.

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


WS_STRING Wert; kann einen Nilwert enthalten (siehe WS_STRING_TYPE)
Api(..., &value, sizeof(value), ...);



wenn der Wert ungleich Null ist

              <Element>hello</element>

wenn der Wert "nil" ist

              <element xsi:nil='true'/>


Diese Option wird nur für die folgenden Typen unterstützt, die unten aufgeführt sind.
die eine systeminterne Möglichkeit zum Darstellen eines Nilwerts haben. Weitere Informationen finden Sie in der Dokumentation
für jeden Typ informationen dazu, wie nil dargestellt wird.
WS_WRITE_NILLABLE_POINTER
Wert: 4
Für alle Typen enthält der angegebene Speicher einen Zeiger auf den Wert. Das
Die größe des angegebenen Speichers ist unabhängig von der Größe eines Zeigers immer die Größe eines Zeigers.
des Typs, der serialisiert wird.

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


int* valuePointer; kann NULL sein
Api(..., &valuePointer, sizeof(valuePointer), ...);



wenn der Wert ungleich NULL ist

              <Element>123</Element>

wenn der Wert NULL ist

              <element xsi:nil='true'/>

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows 7 [Desktop-Apps | UWP-Apps]
mindestens unterstützte Server- Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Header webservices.h
  • Last updated on