Partager via


WS_CREATE_DECODER_CALLBACK fonction de rappel (webservices.h)

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

Syntaxe

WS_CREATE_DECODER_CALLBACK WsCreateDecoderCallback;

HRESULT WsCreateDecoderCallback(
  [in]           void *createContext,
  [in]           WS_READ_CALLBACK readCallback,
  [in]           void *readContext,
                 void **decoderContext,
  [in, optional] WS_ERROR *error
)
{...}

Paramètres

[in] createContext

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

[in] readCallback

Fonction qui doit être utilisée pour lire les données de message. Ce rappel doit uniquement être utilisé en réponse aux rappels WS_DECODER_START_CALLBACK, WS_DECODER_DECODE_CALLBACK et WS_DECODER_END_CALLBACK .

[in] readContext

Contexte de lecture qui doit être passé au WS_READ_CALLBACK fourni.

decoderContext

Retourne le décodeur instance. Cette valeur sera transmise à tous les rappels du décodeur.

[in, optional] error

Spécifie l’emplacement où les 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
Nous avons manqué de mémoire.
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.
Autres erreurs
Cette fonction peut renvoyer d’autres erreurs non répertoriées ci-dessus.

Remarques

Le canal crée des instances de décodeur si nécessaire. Chaque décodeur instance sera appelé de manière monothread. Un décodeur unique instance toutefois ne doit pas supposer qu’il verra tous les messages d’un canal, car le canal peut utiliser plusieurs instances de décodeur 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