WS_ENCODER_GET_CONTENT_TYPE_CALLBACK Rückruffunktion (webservices.h)

Artikel
2023-08-27

Ruft den Inhaltstyp der Nachricht ab.

Syntax

WS_ENCODER_GET_CONTENT_TYPE_CALLBACK WsEncoderGetContentTypeCallback;

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

Parameter

[in] encoderContext

Der Encoder instance vom WS_CREATE_ENCODER_CALLBACK zurückgegeben.

[in] contentType

Der Inhaltstyp der codierten Nachricht.

[out] newContentType

Der Rückruf sollte hier den Inhaltstyp für die neu codierte Nachricht zurückgeben.

[out] contentEncoding

Der Rückruf sollte hier die Inhaltscodierung für die codierte Nachricht zurückgeben.

[in, optional] error

Gibt an, wo zusätzliche Fehlerinformationen gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Rückgabecode	Beschreibung
E_OUTOFMEMORY	Der Arbeitsspeicher ist nicht mehr vorhanden.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Der Rückruf überprüft möglicherweise den angegebenen Inhaltstyp und sollte dann den Inhaltstyp zurückgeben, der für die codierte Nachricht verwendet werden soll.

Der zurückgegebene Inhaltstyp und die Inhaltscodierung müssen gültig bleiben, bis der Rückruf erneut aufgerufen wird oder der Encoder freigegeben wird.

Wenn für WS_HTTP_CHANNEL_BINDING eine Inhaltscodierung der Länge ungleich Null zurückgegeben wird, wird der HTTP-Header "Content-Encoding" der Nachricht mit diesem Wert hinzugefügt.

Bei anderen Kanalbindungen ist es ein Fehler, eine Inhaltscodierung der Länge ungleich 0 (null) zurückzugeben.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h

Freigeben über