enumeración WS_WRITE_OPTION (webservices.h)
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(..., &value, sizeof(value), ...);<br> syntax<br>// always written<br><element>123</element><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(..., &valuePointer, sizeof(valuePointer), ...);<br> syntax<br>// always written<br><element>123</element><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(..., &value, sizeof(value), ...);<br> syntax<br>// if value is non-nil<br><element>hello</element><br><br>// if value is nil<br><element xsi:nil='true'/><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(..., &valuePointer, sizeof(valuePointer), ...);<br><br> syntax<br>// if value is non-NULL<br><element>123</element><br><br>// if value is NULL<br><element xsi:nil='true'/><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 |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de