WS_DECODER_GET_CONTENT_TYPE_CALLBACK funzione di callback (webservices.h)

Articolo
08/27/2023

Ottiene il tipo di contenuto del messaggio.

Sintassi

WS_DECODER_GET_CONTENT_TYPE_CALLBACK WsDecoderGetContentTypeCallback;

HRESULT WsDecoderGetContentTypeCallback(
  [in]           void *decoderContext,
  [in]           const WS_STRING *contentType,
  [in, optional] const WS_STRING *contentEncoding,
  [out]          WS_STRING *newContentType,
  [in, optional] WS_ERROR *error
)
{...}

Parametri

[in] decoderContext

Istanza del codificatore restituita dalla WS_CREATE_DECODER_CALLBACK.

[in] contentType

Tipo di contenuto del messaggio codificato.

[in, optional] contentEncoding

Codifica del contenuto per il messaggio codificato.

[out] newContentType

Il callback deve restituire il tipo di contenuto per il messaggio appena decodificato qui.

[in, optional] error

Specifica la posizione in cui devono essere archiviate informazioni aggiuntive sugli errori se la funzione ha esito negativo.

Valore restituito

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 callback deve verificare che il tipo di contenuto fornito corrisponda a quello previsto, quindi deve restituire il tipo di contenuto del messaggio decodificato.

Il tipo di contenuto restituito deve rimanere valido fino alla successiva chiamata al callback oppure il decodificatore viene liberato.

Il callback deve impostare newContentType su uno supportato dal canale sottostante. Ad esempio, con il canale di sessione TCP usando SOAP 1.2 e codifica binaria, il nuovo tipo di contenuto deve essere sempre application/soap+msbinsession1.

Per WS_HTTP_CHANNEL_BINDING il parametro di codifica del contenuto verrà impostato sul valore dell'intestazione HTTP "Codifica contenuto". Se questa intestazione non esiste, verrà passato NULL .

Per tutte le altre associazioni di canale, NULL verrà passato per la codifica del contenuto.

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