WS_WRITE_OPTION 枚举 (webservices.h)

项目
08/27/2023

指定指定的存储是包含值还是指向值的指针，以及该值是否可以在 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(..., &value, sizeof(value), ...);<br>` `syntax<br>// always written<br><element>123</element><br>` 指针类型不支持此选项 (WS_WSZ_TYPE 和 WS_XML_BUFFER_TYPE) 。应将 WS_WRITE_REQUIRED_POINTER 选项用于这些类型。
`WS_WRITE_REQUIRED_POINTER` 值： 2 指定的存储包含指向值的指针。 The 指定的存储的大小始终是指针的大小，无论大小如何正在序列化的类型的。此选项指定值将始终写入 XML 内容。 `syntax<br>int* valuePointer; // may not be NULL<br>Api(..., &valuePointer, sizeof(valuePointer), ...);<br>` `syntax<br>// always written<br><element>123</element><br>` 如果指向存储中指定的值的指针为 NULL，返回E_INVALIDARG 。 (请参阅 Windows Web Services 返回值。)
`WS_WRITE_NILLABLE_VALUE` 值： 3 指定的存储包含指向值的指针。 The 指定的存储的大小始终是指针的大小，无论大小如何正在序列化的类型的。如果值为 nil，则在 XML 内容中写入 nil 元素。如果为非 nil，则该值将正常序列化。 `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>` 此选项仅支持以下类型，如下所示：具有表示零值的内部方式。请参阅文档，了解 nil 的表示方式。 WS_STRING_TYPE WS_XML_STRING_TYPE WS_BYTES_TYPE
`WS_WRITE_NILLABLE_POINTER` 值： 4 对于所有类型，指定的存储包含指向值的指针。 The 指定的存储的大小始终是指针的大小，无论大小如何正在序列化的类型的。如果指向存储中指定的值的指针为 NULL，则在 XML 内容中写入 nil 元素。 `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>`

要求


最低受支持的客户端	Windows 7 [桌面应用 \|UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 \|UWP 应用]
标头	webservices.h

WS_WRITE_OPTION 枚举 (webservices.h)

语法

常量

要求

反馈

反馈

其他资源