WS_WRITE_OPTION webservices.h (列舉)

指定指定的儲存體是否包含值或值的指標，以及值是否可以在 XML 內容中表示為 nil。

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;

常數

WS_WRITE_REQUIRED_VALUE 值： 1 指定的儲存體包含 值。 儲存體的大小 指定的 應該是值的大小。 此選項會指定值一律會寫入 XML 內容。 syntax<br>int value;<br>Api(..., &amp;value, sizeof(value), ...);<br> syntax<br>// always written<br>&lt;element&gt;123&lt;/element&gt;<br> 指標類型不支援此選項 (WS_WSZ_TYPE 和 WS_XML_BUFFER_TYPE) 。 WS_WRITE_REQUIRED_POINTER選項應該用於這些類型。
WS_WRITE_REQUIRED_POINTER 值： 2 指定的儲存體包含值的指標。 此 指定的儲存體大小一律是指標的大小，不論 正在序列化之型別的 。 此選項會指定值一律會寫入 XML 內容。 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> 如果儲存體中指定的值指標是 Null， 傳回E_INVALIDARG 。 (請參閱 Windows Web 服務傳回值。)
WS_WRITE_NILLABLE_VALUE 值： 3 指定的儲存體包含值的指標。 此 指定的儲存體大小一律是指標的大小，不論 正在序列化之型別的 。 如果值為 nil，則會在 XML 內容中寫入 nil 元素。 如果非 nil，則此值會正常序列化。 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> 此選項僅支援下列類型，如下所列： 具有表示 nil 值的內建方式。 請參閱檔 針對每個類型，以取得 nil 表示方式的相關資訊。 WS_STRING_TYPE WS_XML_STRING_TYPE WS_BYTES_TYPE
WS_WRITE_NILLABLE_POINTER 值： 4 針對所有類型，指定的儲存體包含值的指標。 此 指定的儲存體大小一律是指標的大小，不論 正在序列化之型別的 。 如果儲存體中指定的值指標是 Null，則 nil 元素會以 XML 內容撰寫。 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>

規格需求

最低支援的用戶端	Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
標頭	webservices.h