WS_PULL_BYTES_CALLBACK fonction de rappel (webservices.h)

Article
03/03/2024

Utilisé par la fonction WsPullBytes pour demander les données qui doivent être écrites.

Syntaxe

WS_PULL_BYTES_CALLBACK WsPullBytesCallback;

HRESULT WsPullBytesCallback(
  [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

État défini par l’utilisateur qui a été passé à WsPullBytes.

bytes

Emplacement où les données lues doivent être placées.

[in] maxSize

Nombre maximal d’octets pouvant être lus.

[out] actualSize

Nombre réel d’octets qui ont été lus. Cela peut être inférieur à maxSize. Le retour de 0 indique qu’il n’y a plus de données.

[in, optional] asyncContext

Informations sur la façon d’appeler la fonction de manière asynchrone, ou NULL en cas d’appel synchrone.

[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

Code de retour	Description
WS_S_ASYNC	L’opération asynchrone est toujours en attente.

Remarques

Le retour de la taille 0 indique EOF.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h

Partager via