WsPullBytes, fonction (webservices.h)

Configure un rappel à appeler pour obtenir les octets à écrire dans un élément.
Dans certains encodages, cela peut être plus efficace en éliminant une copie des données.

Syntaxe

HRESULT WsPullBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PULL_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

Paramètres

[in] writer

Writer dans lequel les octets seront écrits.

[in] callback

Rappel à appeler quand il est temps d’écrire les données binaires.

[in, optional] callbackState

État défini par l’utilisateur à passer au rappel.

[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 peut retourner l’une de ces valeurs.

Remarques

WsWriteBytes et WsPushBytes nécessitent que la mémoire tampon des données soit fournie au writer. Dans certains modèles d’utilisation, une copie supplémentaire des données peut être nécessaire. Pour ces scénarios, WsPullBytes offre un moyen de demander à l’enregistreur de fournir la mémoire tampon qui doit être remplie de données.

Si l’encodage ne peut pas tirer parti de ce comportement, WsPullBytes appelle immédiatement le rappel et fonctionne comme si WsWriteBytes avait été appelé sur les données résultantes.

Configuration requise