Partager via


WS_CREATE_ENCODER_CALLBACK fonction de rappel (webservices.h)

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