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.

Sintaxis

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.


int value;
Api(..., &valor, sizeof(value), ...);



siempre escrito
123


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 . El
el tamaño del almacenamiento especificado siempre es el tamaño de un puntero, independientemente de
del tipo que se va a serializar.

Esta opción especifica que el valor siempre se escribirá en el contenido XML.


int* valuePointer; puede que no sea NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



siempre escrito
123


Si el puntero al valor especificado en el almacenamiento es null,
se devuelve E_INVALIDARG.
(Consulte valores devueltos de servicios web de Windows).
WS_WRITE_NILLABLE_VALUE
Valor: 3
El almacenamiento especificado contiene un puntero al valor . El
el tamaño del almacenamiento especificado siempre es el tamaño de un puntero, independientemente de
del tipo que se va a serializar.

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


WS_STRING valor; puede contener un valor nulo (vea WS_STRING_TYPE)
Api(..., &valor, sizeof(value), ...);



si el valor no es nulo
hello

si el valor es nulo



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 nil.
WS_WRITE_NILLABLE_POINTER
Valor: 4
Para todos los tipos, el almacenamiento especificado contiene un puntero al valor . El
el tamaño del almacenamiento especificado siempre es el tamaño de un puntero, independientemente de
del tipo que se va a serializar.

Si el puntero al valor especificado en el almacenamiento es NULL,
Un elemento nulo se escribe en el contenido XML.


int* valuePointer; puede ser NULL
Api(..., &valuePointer, sizeof(valuePointer), ...);



si el valor no es NULL
123

si value es NULL

Requisitos

Requisito Valor
cliente mínimo admitido Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
servidor mínimo admitido Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
encabezado de webservices.h