Compartir a través de

enumeración WS_WRITE_OPTION (webservices.h)

  • Artículo

Especifica si un almacenamiento especificado contiene el valor o un puntero al valor y si el valor se puede representar como nulo en el contenido 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
Valor: 1
El almacenamiento especificado contiene el valor . Tamaño del almacenamiento
especificado debe ser el tamaño del valor.


Esta opción especifica que el valor siempre se escribirá en el contenido 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>

Esta opción no se admite para los tipos de puntero.
(WS_WSZ_TYPE y WS_XML_BUFFER_TYPE).
La opción WS_WRITE_REQUIRED_POINTER debe usarse para estos tipos.
WS_WRITE_REQUIRED_POINTER
Valor: 2
El almacenamiento especificado contiene un puntero al valor . The
el tamaño del almacenamiento especificado es siempre el tamaño de un puntero, independientemente de
del tipo que se está serializando.


Esta opción especifica que el valor siempre se escribirá en el contenido 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 el puntero al valor especificado en el almacenamiento es NULL,
E_INVALIDARG se devuelve.
(Vea Valores devueltos de servicios web de Windows).
WS_WRITE_NILLABLE_VALUE
Valor: 3
El almacenamiento especificado contiene un puntero al valor . The
el tamaño del almacenamiento especificado es siempre el tamaño de un puntero, independientemente de
del tipo que se está serializando.


Si el valor es nulo, se escribe un elemento nulo en el contenido XML.
Si no es nulo, el valor se serializa normalmente.



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>

Esta opción solo se admite para los siguientes tipos, que se enumeran a continuación,
que tienen una manera intrínseca de representar un valor nulo. Consulte la documentación
para cada tipo para obtener información sobre cómo se representa el valor nulo.
WS_WRITE_NILLABLE_POINTER
Valor: 4
Para todos los tipos, el almacenamiento especificado contiene un puntero al valor . The
el tamaño del almacenamiento especificado es siempre el tamaño de un puntero, independientemente de
del tipo que se está serializando.


Si el puntero al valor especificado en el almacenamiento es NULL, entonces
Un elemento nulo se escribe en el contenido 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>

Requisitos

   
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h