WS_CREATE_DECODER_CALLBACK funzione di callback (webservices.h)

Articolo
03/13/2024

Gestisce la creazione di un'istanza del decodificatore.

Sintassi

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
)
{...}

Parametri

[in] createContext

CreateContext specificato nella WS_CHANNEL_DECODER utilizzata durante la creazione del canale.

[in] readCallback

Funzione che deve essere utilizzata per leggere i dati del messaggio. Questo callback deve essere usato solo in risposta alle WS_DECODER_START_CALLBACK, WS_DECODER_DECODE_CALLBACK e WS_DECODER_END_CALLBACK callback.

[in] readContext

Contesto di lettura che deve essere passato al WS_READ_CALLBACK fornito.

decoderContext

Restituisce l'istanza del decodificatore. Questo valore verrà passato a tutti i callback del decodificatore.

[in, optional] error

Specifica dove archiviare informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Questa funzione di callback può restituire uno di questi valori.

Codice restituito	Descrizione
E_OUTOFMEMORY	Memoria insufficiente.
E_INVALIDARG	Uno o più argomenti non sono validi.
Altri errori	Questa funzione può restituire altri errori non elencati in precedenza.

Commenti

Il canale creerà le istanze del decodificatore in base alle esigenze. Ogni istanza del decodificatore verrà chiamata in modo a thread singolo. Una singola istanza del decodificatore, tuttavia, non deve presupporre che visualizzerà tutti i messaggi da un canale, perché il canale può usare più istanze del decodificatore per l'elaborazione dei messaggi.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	webservices.h

Condividi tramite