WsCreateListener-Funktion (webservices.h)

Artikel
08/27/2023

Erstellt einen Listener mit den angegebenen Eigenschaften.

Syntax

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

Parameter

[in] channelType

Der Kanaltyp, auf den der Listener lauscht. Informationen zu Kanaltypen finden Sie in der WS_CHANNEL_TYPE-Enumeration .

[in] channelBinding

Das Kanalprotokoll für den Listener. Mögliche Bindungen finden Sie in der WS_CHANNEL_BINDING-Enumeration .

properties

Zeiger auf eine WS_LISTENER_PROPERTY-Struktur , die optionale Eigenschaften für den Listener enthält.

Informationen dazu, welche Eigenschaften Sie beim Erstellen eines Listeners angeben können, finden Sie in der WS_LISTENER_PROPERTY_ID-Enumeration .

Informationen zum Erstellen eines benutzerdefinierten Listeners finden Sie im Abschnitt Hinweise.

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

[in, optional] securityDescription

Zeiger auf eine WS_SECURITY_DESCRIPTION-Struktur , die die Sicherheit für den Listener angibt.

Wenn Sie einen benutzerdefinierten Kanal erstellen (mit dem WS_CUSTOM_CHANNEL_BINDING Wert der WS_CHANNEL_BINDING-Enumeration ), muss die Sicherheitsbeschreibung NULL sein. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.

listener

Bei Erfolg ein Zeiger, der die Adresse der WS_LISTENER Struktur empfängt, die den neuen Listener darstellt.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
WS_E_QUOTA_EXCEEDED	Ein Kontingent wurde überschritten.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
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

Wenn Sie einen benutzerdefinierten Listener erstellen (mit dem WS_CUSTOM_CHANNEL_BINDING Wert der WS_CHANNEL_BINDING-Enumeration ), können Sie nur die folgenden Kanaleigenschaften angeben:

WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS

(Siehe WS_LISTENER_PROPERTY_ID-Enumeration .) Wenn zum Erstellen des benutzerdefinierten Listeners andere anfängliche Eigenschaften erforderlich sind, geben Sie diese mithilfe der WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS-Eigenschaft an.

Um Sicherheitsinformationen an eine benutzerdefinierte Listenerimplementierung zu übergeben, verwenden Sie den WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS-Wert der WS_LISTENER_PROPERTY_ID-Enumeration .

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
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über