enumerasi WS_WRITE_OPTION (webservices.h)

Menentukan apakah penyimpanan yang ditentukan berisi nilai, atau penunjuk ke nilai, dan apakah nilai dapat direpresentasikan sebagai nihil dalam konten XML.

Sintaks

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;

Konstanta

WS_WRITE_REQUIRED_VALUE Nilai: 1 Penyimpanan yang ditentukan berisi nilai . Ukuran penyimpanan yang ditentukan harus menjadi ukuran nilai. Opsi ini menentukan bahwa nilai akan selalu ditulis ke konten 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> Opsi ini tidak didukung untuk jenis penunjuk (WS_WSZ_TYPE dan WS_XML_BUFFER_TYPE). Opsi WS_WRITE_REQUIRED_POINTER harus digunakan untuk jenis ini.
WS_WRITE_REQUIRED_POINTER Nilai: 2 Penyimpanan yang ditentukan berisi penunjuk ke nilai . The ukuran penyimpanan yang ditentukan selalu ukuran penunjuk, terlepas dari jenis yang sedang diserialisasikan. Opsi ini menentukan bahwa nilai akan selalu ditulis ke konten 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> Jika penunjuk ke nilai yang ditentukan dalam penyimpanan adalah NULL, E_INVALIDARG dikembalikan. (Lihat Nilai Pengembalian Windows Web Services.)
WS_WRITE_NILLABLE_VALUE Nilai: 3 Penyimpanan yang ditentukan berisi penunjuk ke nilai . The ukuran penyimpanan yang ditentukan selalu ukuran penunjuk, terlepas dari jenis yang sedang diserialisasikan. Jika nilainya nihil, maka elemen nihil ditulis dalam konten XML. Jika non-nihil, maka nilai diserialisasikan secara normal. 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> Opsi ini hanya didukung untuk jenis berikut, tercantum di bawah ini, yang memiliki cara intrinsik untuk mewakili nilai nihil. Lihat dokumentasi untuk setiap jenis untuk informasi tentang bagaimana nihil diwakili. WS_STRING_TYPE WS_XML_STRING_TYPE WS_BYTES_TYPE
WS_WRITE_NILLABLE_POINTER Nilai: 4 Untuk semua jenis, penyimpanan yang ditentukan berisi penunjuk ke nilai . The ukuran penyimpanan yang ditentukan selalu ukuran penunjuk, terlepas dari jenis yang sedang diserialisasikan. Jika penunjuk ke nilai yang ditentukan dalam penyimpanan adalah NULL, maka elemen nihil ditulis dalam konten 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>

Persyaratan

Klien minimum yang didukung	Windows 7 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP]
Header	webservices.h