WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK Rückruffunktion (webservices.h)

Artikel
03/06/2024

Verarbeitet den WsCreateChannelForListener-Aufruf für eine WS_CUSTOM_CHANNEL_BINDING.

Syntax

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

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

Parameter

[in] listenerInstance

Der Zeiger auf den Status, der für diesen Listener spezifisch ist, instance, wie er vom WS_CREATE_LISTENER_CALLBACK erstellt wird.

channelParameters

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

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

[in] channelParametersSize

Die Größe des Werts in Byte, auf den channelParameters verweist.

Wenn die WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS-Eigenschaft nicht angegeben wurde, beträgt die Größe 0.

channelInstance

Ein Zeiger auf eine Struktur, die durch den Rückruf zugeordnet wird, die die spezifischen Daten für diesen Kanal 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 die WS_FREE_CHANNEL_CALLBACK verwendet, um den Kanal freizugeben instance, der in diesem Parameter zurückgegeben wird.

[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.

Hinweise

Informationen zum Vertrag dieser API finden Sie unter WsCreateChannelForListener .

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

Freigeben über