WS_CREATE_CHANNEL_CALLBACK Rückruffunktion (webservices.h)

  • Artikel

Verarbeitet den WsCreateChannel-Aufruf für einen WS_CUSTOM_CHANNEL_BINDING.

Syntax

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

HRESULT WsCreateChannelCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] channelType

Das Nachrichtenaustauschmuster des Kanals.

Wenn der Kanaltyp von der benutzerdefinierten Kanalimplementierung nicht unterstützt wird, sollte E_INVALIDARG zurückgegeben werden.

channelParameters

Der Zeiger auf den Wert, der von der WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS-Eigenschaft angegeben wurde, wenn der benutzerdefinierte Kanal mit WsCreateChannel erstellt wird.

Wenn die WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS-Eigenschaft nicht angegeben wurde, ist der Wert NULL.

[in] channelParametersSize

Die Größe des Werts in Bytes, auf den von channelParameters verwiesen wird.

Wenn die WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS-Eigenschaft nicht angegeben wurde, ist die Größe 0.

channelInstance

Ein Zeiger auf eine Struktur, die durch den Rückruf zugeordnet ist und die für diesen Kanal spezifischen Daten enthält, instance. Dieser Zeiger wird an alle anderen Kanalrückrufe für diesen bestimmten Kanal instance übergeben.

Wenn dieser Rückruf erfolgreich ist, wird der WS_FREE_CHANNEL_CALLBACK verwendet, um den Kanal freizugeben instance in diesem Parameter zurückgegeben.

[in, optional] error

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

Rückgabewert

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

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