WS_WRITE_OPTION 枚举 (webservices.h)
指定指定的存储是包含值还是指向值的指针,以及该值是否可以在 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_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 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈