Condividi tramite

WS_IS_DEFAULT_VALUE_CALLBACK funzione di callback (webservices.h)

  • Articolo

Determina se un valore è il valore predefinito. Questo callback viene utilizzato prima della serializzazione di un valore gestito da un WS_CUSTOM_TYPE . Il supporto per i valori predefiniti è abilitato specificando quando WS_FIELD_OPTIONAL nel WS_FIELD_DESCRIPTION.

Sintassi

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

Parametri

[in] descriptionData

Questo è il valore del campo descriptionData di WS_CUSTOM_TYPE_DESCRIPTION. Il callback può usarlo per accedere a qualsiasi informazione aggiuntiva sul tipo.

value

Puntatore al valore da serializzare.

defaultValue

Puntatore al valore predefinito. Se non è stato specificato alcun valore predefinito per il campo, questo parametro sarà NULL.

Se il parametro è diverso da NULL, il callback deve confrontare i due valori field-by-field in base al tipo personalizzato. Se i campi corrispondono, il parametro isDefault deve essere impostato su TRUE.

Se il parametro è NULL, il callback deve confrontare i campi del valore con zero. Se i campi corrispondono, il parametro isDefault deve essere impostato su TRUE.

[in] valueSize

Dimensione, in byte, del valore serializzato.

[out] isDefault

Indica se il valore è il valore predefinito.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback non restituisce un valore.

Requisiti

   
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione webservices.h