Compartilhar via


WS_IS_DEFAULT_VALUE_CALLBACK função de retorno de chamada (webservices.h)

Determina se um valor é o valor padrão. Esse retorno de chamada é usado antes que um valor tratado por um WS_CUSTOM_TYPE seja serializado. O suporte para valores padrão é habilitado especificando quando WS_FIELD_OPTIONAL no WS_FIELD_DESCRIPTION.

Sintaxe

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
)
{...}

Parâmetros

[in] descriptionData

Esse é o valor do campo descriptionData de WS_CUSTOM_TYPE_DESCRIPTION. O retorno de chamada pode usar isso para acessar informações adicionais sobre o tipo.

value

Um ponteiro para o valor que está sendo serializado.

defaultValue

Um ponteiro para o valor padrão. Se nenhum valor padrão tiver sido especificado para o campo, esse parâmetro será NULL.

Se o parâmetro não for NULL, o retorno de chamada deverá comparar os dois valores campo a campo de acordo com o tipo personalizado. Se os campos corresponderem, o parâmetro isDefault deverá ser definido como TRUE.

Se o parâmetro for NULL, o retorno de chamada deverá comparar os campos do valor com zero. Se os campos corresponderem, o parâmetro isDefault deverá ser definido como TRUE.

[in] valueSize

O tamanho, em bytes, do valor que está sendo serializado.

[out] isDefault

Se o valor é ou não o valor padrão.

[in, optional] error

Especifica onde informações adicionais de erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função de retorno de chamada não retorna um valor.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho webservices.h