WS_CREATE_DECODER_CALLBACK fonction de rappel (webservices.h)

Article
03/03/2024

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

Partager via