WS_IS_DEFAULT_VALUE_CALLBACK fonction de rappel (webservices.h)

Article
08/27/2023

Détermine si une valeur est la valeur par défaut. Ce rappel est utilisé avant qu’une valeur gérée par un WS_CUSTOM_TYPE ne soit sérialisée. La prise en charge des valeurs par défaut est activée en spécifiant quand WS_FIELD_OPTIONAL dans le WS_FIELD_DESCRIPTION.

Syntaxe

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

Paramètres

[in] descriptionData

Il s’agit de la valeur du champ descriptionData de WS_CUSTOM_TYPE_DESCRIPTION. Le rappel peut l’utiliser pour accéder à des informations supplémentaires sur le type.

value

Pointeur vers la valeur sérialisée.

defaultValue

Pointeur vers la valeur par défaut. Si aucune valeur par défaut n’a été spécifiée pour le champ, ce paramètre est NULL.

Si le paramètre n’est pas NULL, le rappel doit comparer les deux valeurs champ par champ en fonction du type personnalisé. Si les champs correspondent, le paramètre isDefault doit être défini sur TRUE.

Si le paramètre a la valeur NULL, le rappel doit comparer les champs de la valeur à zéro. Si les champs correspondent, le paramètre isDefault doit être défini sur TRUE.

[in] valueSize

Taille, en octets, de la valeur sérialisée.

[out] isDefault

Indique si la valeur est la valeur par défaut ou non.

[in, optional] error

Spécifie l’emplacement où des informations d’erreur supplémentaires doivent être stockées en cas d’échec de la fonction.

Valeur retournée

Cette fonction de rappel ne retourne pas de valeur.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	webservices.h

Partager via