WS_CREATE_ENCODER_CALLBACK fonction de rappel (webservices.h)

Article
03/06/2024

Gère la création d’un instance d’encodeur.

Syntaxe

WS_CREATE_ENCODER_CALLBACK WsCreateEncoderCallback;

HRESULT WsCreateEncoderCallback(
  [in]           void *createContext,
  [in]           WS_WRITE_CALLBACK writeCallback,
  [in]           void *writeContext,
                 void **encoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] createContext

CreateContext spécifié dans le WS_CHANNEL_ENCODER utilisé lors de la création du canal.

[in] writeCallback

Fonction qui doit être utilisée pour écrire les données de message. Ce rappel doit être utilisé uniquement en réponse aux rappels WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK et WS_ENCODER_END_CALLBACK .

[in] writeContext

Contexte d’écriture qui doit être passé à l’WS_WRITE_CALLBACK fourni.

encoderContext

Retourne le instance de l’encodeur. Cette valeur sera passée à tous les rappels d’encodeur.

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

Code de retour	Description
E_OUTOFMEMORY	Mémoire insuffisante.
E_INVALIDARG	Un ou plusieurs arguments ne sont pas valides.
Autres erreurs	Cette fonction peut retourner d’autres erreurs non répertoriées ci-dessus.

Remarques

Le canal crée des instances d’encodeur si nécessaire. Chaque instance d’encodeur est appelé de manière monothread. Toutefois, un seul encodeur instance ne doit pas supposer qu’il verra tous les messages d’un canal, car le canal peut utiliser plusieurs instances d’encodeur pour le traitement des messages.

Configuration requise

Condition requise	Valeur
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