énumération WS_WRITE_OPTION (webservices.h)

Spécifie si un stockage spécifié contient la valeur ou un pointeur vers la valeur, et si la valeur peut être représentée comme nulle dans le contenu XML.

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;

Constantes

WS_WRITE_REQUIRED_VALUE Valeur : 1 Le stockage spécifié contient la valeur . Taille du stockage spécifié doit être la taille de la valeur. Cette option spécifie que la valeur sera toujours écrite dans le contenu 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> Cette option n’est pas prise en charge pour les types de pointeurs (WS_WSZ_TYPE et WS_XML_BUFFER_TYPE). L’option WS_WRITE_REQUIRED_POINTER doit être utilisée pour ces types.
WS_WRITE_REQUIRED_POINTER Valeur : 2 Le stockage spécifié contient un pointeur vers la valeur . The la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille du type sérialisé. Cette option spécifie que la valeur sera toujours écrite dans le contenu 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> Si le pointeur vers la valeur spécifiée dans le stockage est NULL, E_INVALIDARG est retourné. (Voir Valeurs de retour des services Web Windows.)
WS_WRITE_NILLABLE_VALUE Valeur : 3 Le stockage spécifié contient un pointeur vers la valeur . The la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille du type sérialisé. Si la valeur est nil, un élément nil est écrit dans le contenu XML. Si elle n’est pas nulle, la valeur est sérialisée normalement. 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> Cette option est uniquement prise en charge pour les types suivants, répertoriés ci-dessous, qui ont un moyen intrinsèque de représenter une valeur nulle. Consultez la documentation pour chaque type pour obtenir des informations sur la façon dont nil est représenté. WS_STRING_TYPE WS_XML_STRING_TYPE WS_BYTES_TYPE
WS_WRITE_NILLABLE_POINTER Valeur : 4 Pour tous les types, le stockage spécifié contient un pointeur vers la valeur. The la taille du stockage spécifié est toujours la taille d’un pointeur, quelle que soit la taille du type sérialisé. Si le pointeur vers la valeur spécifiée dans le stockage est NULL, alors un élément nil est écrit dans le contenu 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>

Configuration requise

Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête	webservices.h