WS_READ_CALLBACK fonction de rappel (webservices.h)

Utilisé par le WS_XML_READER pour lire à partir d’une source dans une mémoire tampon.

Syntaxe

WS_READ_CALLBACK WsReadCallback;

HRESULT WsReadCallback(
  [in]           void *callbackState,
                 void *bytes,
  [in]           ULONG maxSize,
  [out]          ULONG *actualSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] callbackState

Pointeur void vers la valeur d’état définie par l’utilisateur qui a été passée à la fonction qui a accepté ce rappel.

bytes

Pointeur void vers l’emplacement où les données doivent être placées.

[in] maxSize

Nombre maximal d’octets pouvant être lus.

[out] actualSize

Pointeur vers une valeur ULONG qui indique le nombre d’octets réellement lus. Cela peut être inférieur à maxSize. Le retour de 0 indique qu’il n’y a plus de données.

[in, optional] asyncContext

Pointeur vers une structure WS_ASYNC_CONTEXT contenant des informations sur la façon d’appeler la fonction de manière asynchrone. Valeur NULL affectée en cas d’appel synchrone.

[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 retour de la taille 0 dans le paramètre de sortie actualSize indique la fin du fichier.

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