WS_CREATE_LISTENER_CALLBACK Rückruffunktion (webservices.h)

Artikel
08/27/2023

Verarbeitet den WsCreateListener-Aufruf für einen WS_CUSTOM_CHANNEL_BINDING.

Syntax

WS_CREATE_LISTENER_CALLBACK WsCreateListenerCallback;

HRESULT WsCreateListenerCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *listenerParameters,
  [in]           ULONG listenerParametersSize,
                 void **listenerInstance,
  [in, optional] WS_ERROR *error
)
{...}

Parameter

[in] channelType

Der Kanaltyp, auf den der Listener lauscht.

listenerParameters

Der Zeiger auf den Wert, der von der WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS-Eigenschaft angegeben wurde, wenn der benutzerdefinierte Listener mit WsCreateListener erstellt wird.

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

[in] listenerParametersSize

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

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

listenerInstance

Ein Zeiger auf eine zugeordnete Struktur, die den Listener instance darstellt. Dieser Zeiger wird an alle anderen Listenerrückrufe für diesen bestimmten Listener instance übergeben.

Wenn dieser Rückruf erfolgreich ist, wird der WS_FREE_LISTENER_CALLBACK verwendet, um den Listener instance freizugeben.

[in, optional] error

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

Rückgabewert

Rückgabecode	Beschreibung
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.
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.

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