WS_READ_TYPE_CALLBACK fonction de rappel (webservices.h)

Article
08/27/2023

Lit une valeur quand WS_TYPE a été spécifié. Cela permet de lire des constructions XML qui ne sont pas facilement mappées au modèle de sérialisation de base.

Syntaxe

WS_READ_TYPE_CALLBACK WsReadTypeCallback;

HRESULT WsReadTypeCallback(
  [in]           WS_XML_READER *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           const void *descriptionData,
  [in, optional] WS_HEAP *heap,
                 void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] reader

Pointeur vers un handle WS_XML_READER qui contient la valeur de type.

[in] typeMapping

Indique comment le xml est mappé à ce type.

Si un mappage n’a pas de sens pour ce type particulier, le rappel doit retourner WS_E_INVALID_OPERATION. (Voir Valeurs de retour des services Web Windows.) Une implémentation de rappel doit être préparée à passer de nouveaux types de mappage dans les versions ultérieures et doit retourner WS_E_INVALID_OPERATION pour ces cas.

[in] descriptionData

Pointeur vers la valeur du champ descriptionData d’une structure WS_CUSTOM_TYPE_DESCRIPTION . Le rappel peut l’utiliser pour accéder à des informations supplémentaires sur le type.

[in, optional] heap

Pointeur vers le tas à utiliser pour allouer toutes les données supplémentaires associées à ce type, telles que ses champs imbriqués.

Notez que ce paramètre peut être NULL si l’appelant n’a pas spécifié d’objet WS_HEAP lors de la désérialisation du type.

value

Pointeur vers une mémoire tampon qui contient la valeur en cours de désérialisation. Le rappel est chargé de renseigner la valeur en fonction du contenu actuel du lecteur et du typeMapping. Le rappel peut utiliser le tas fourni si nécessaire pour allouer des valeurs associées à la valeur.

[in] valueSize

Taille de la mémoire tampon en cours de désérialisation. La mémoire tampon est allouée en fonction de la taille spécifiée dans le WS_CUSTOM_TYPE_DESCRIPTION.

[in, optional] error

Pointeur vers WS_ERROR structure de données 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.

Remarques

Le rappel sera appelé avec la même séquence d’appel que WsReadType dans la documentation pour WS_TYPE_MAPPING. Cela définit les parties du code XML que le rappel doit lire.

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