WS_CREATE_ENCODER_CALLBACK funzione di callback (webservices.h)

Articolo
03/13/2024

Gestisce la creazione di un'istanza del codificatore.

Sintassi

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

Parametri

[in] createContext

CreateContext specificato nella WS_CHANNEL_ENCODER utilizzata durante la creazione del canale.

[in] writeCallback

Funzione che deve essere usata per scrivere i dati del messaggio. Questo callback deve essere usato solo in risposta alla WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK e WS_ENCODER_END_CALLBACK callback.

[in] writeContext

Contesto di scrittura che deve essere passato al WS_WRITE_CALLBACK specificato.

encoderContext

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

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori 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 sopra.

Commenti

Il canale creerà istanze del codificatore in base alle esigenze. Ogni istanza del codificatore verrà chiamata in modo a thread singolo. Un'istanza del codificatore singolo, tuttavia, non deve presupporre che visualizzerà tutti i messaggi da un canale, poiché il canale può usare più istanze del codificatore 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