WS_WRITE_OPTION列挙 (webservices.h)

  • [アーティクル]

指定したストレージに値が含まれているか、値へのポインターが含まれているか、および XML コンテンツで値を nil として表すことができるかどうかを指定します。

構文

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 Services の戻り値」を参照してください)。
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_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 アプリ]
Header webservices.h