Freigeben über


WS_CREATE_ENCODER_CALLBACK Rückruffunktion (webservices.h)

Behandelt das Erstellen eines Encoder-instance.

Syntax

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

Parameter

[in] createContext

Der createContext, der in der WS_CHANNEL_ENCODER angegeben wurde, die bei der Kanalerstellung verwendet wurde.

[in] writeCallback

Die Funktion, die zum Schreiben der Nachrichtendaten verwendet werden soll. Dieser Rückruf sollte nur als Reaktion auf die WS_ENCODER_START_CALLBACK, WS_ENCODER_ENCODE_CALLBACK und WS_ENCODER_END_CALLBACK Rückrufe verwendet werden.

[in] writeContext

Der Schreibkontext, der an die angegebene WS_WRITE_CALLBACK übergeben werden soll.

encoderContext

Gibt den Encoder instance zurück. Dieser Wert wird an alle Encoderrückrufe übergeben.

[in, optional] error

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

Rückgabewert

Diese Rückruffunktion kann einen dieser Werte zurückgeben.

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 Kanal erstellt bei Bedarf Encoderinstanzen. Jeder Encoder instance wird auf Singlethread-Weise aufgerufen. Ein einzelner Encoder instance sollte jedoch nicht davon ausgehen, dass alle Nachrichten von einem Kanal angezeigt werden, da der Kanal möglicherweise mehrere Encoderinstanzen für die Verarbeitung von Nachrichten verwendet.

Anforderungen

Anforderung Wert
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