функция обратного вызова WS_IS_DEFAULT_VALUE_CALLBACK (webservices.h)

Статья
08/27/2023

Определяет, является ли значение значением по умолчанию. Этот обратный вызов используется перед сериализацией значения, обрабатываемого WS_CUSTOM_TYPE . Поддержка значений по умолчанию включается путем указания времени WS_FIELD_OPTIONAL в WS_FIELD_DESCRIPTION.

Синтаксис

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

Это значение поля descriptionData из WS_CUSTOM_TYPE_DESCRIPTION. Обратный вызов может использовать его для доступа к любым дополнительным сведениям о типе.

value

Указатель на сериализуемое значение.

defaultValue

Указатель на значение по умолчанию. Если для поля не указано значение по умолчанию, этот параметр будет иметь значение NULL.

Если параметр не равен NULL, обратный вызов должен сравнить два значения по полю в соответствии с пользовательским типом. Если поля совпадают, параметру isDefault следует задать значение TRUE.

Если параметр имеет значение NULL, обратный вызов должен сравнить поля значения с нулем. Если поля совпадают, параметру isDefault следует задать значение TRUE.

[in] valueSize

Размер сериализуемого значения (в байтах).

[out] isDefault

Указывает, является ли значение значением по умолчанию.

[in, optional] error

Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция обратного вызова не возвращает значение.

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	webservices.h

Поделиться через