WS_IS_DEFAULT_VALUE_CALLBACK回调函数 (webservices.h)

确定值是否为默认值。 此回调在序列化 WS_CUSTOM_TYPE 处理的值之前使用。 通过指定WS_FIELD_DESCRIPTION中何时WS_FIELD_OPTIONAL,可以启用对默认值的支持。

语法

WS_IS_DEFAULT_VALUE_CALLBACK WsIsDefaultValueCallback;

HRESULT WsIsDefaultValueCallback(
  [in]           const void *descriptionData,
                 const void *value,
                 const void *defaultValue,
  [in]           ULONG valueSize,
  [out]          BOOL *isDefault,
  [in, optional] WS_ERROR *error
)
{...}

参数

[in] descriptionData

这是 WS_CUSTOM_TYPE_DESCRIPTION中的 descriptionData 字段的值。 回调可以使用它来访问有关类型的任何其他信息。

value

指向要序列化的值的指针。

defaultValue

指向默认值的指针。 如果未为字段指定默认值,则此参数将为 NULL

如果参数为非 NULL,则回调应根据自定义类型逐字段比较两个值。 如果字段匹配,则应将 isDefault 参数设置为 TRUE

如果参数为 NULL,则回调应将值的字段与零进行比较。 如果字段匹配,则应将 isDefault 参数设置为 TRUE

[in] valueSize

要序列化的值的大小(以字节为单位)。

[out] isDefault

该值是否为默认值。

[in, optional] error

指定函数失败时应存储其他错误信息的位置。

返回值

此回调函数不返回值。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 webservices.h