WsCreateChannelForListener-Funktion (webservices.h)

Artikel
03/03/2024

Erstellt einen Kanal , der einem angegebenen Listener zugeordnet ist.

Syntax

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

Parameter

[in] listener

Zeiger auf eine WS_LISTENER Struktur, die den Listener darstellt, für den ein Kanal erstellt werden soll. Der Listener kann sich in einem beliebigen Zustand befinden. (Listenerzustände finden Sie in der WS_LISTENER_STATE-Enumeration .)

properties

Ein Array von WS_CHANNEL_PROPERTY Strukturen, die optionale Werte für die Kanalinitialisierung enthalten. Dies kann null sein. In diesem Fall muss der propertyCount-Parameter 0 (null) sein.

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

[in] propertyCount

Die Anzahl der Eigenschaften im Eigenschaftenarray .

channel

Bei Erfolg ein Zeiger, der die Adresse des erstellten Kanals empfängt.
Wenn der Kanal nicht mehr benötigt wird, müssen Sie ihn freigeben, indem Sie WsFreeChannel aufrufen.

[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, gibt sie NO_ERROR zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	Beschreibung
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Unzureichender Arbeitsspeicher, um den Vorgang abzuschließen.
Andere Fehler	Diese Funktion gibt möglicherweise andere Fehler zurück, die oben nicht aufgeführt sind.

Hinweise

Um einen eingehenden Nachrichtenaustausch zu akzeptieren, rufen Sie die Funktion WsAcceptChannel auf.

Die Sicherheitsmerkmale des Kanals sind identisch mit denen, die für den Listener angegeben sind.

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

WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS

Wenn zum Erstellen des benutzerdefinierten Kanals anfängliche Eigenschaften erforderlich sind, geben Sie sie mithilfe der eigenschaft WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS an.

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

Freigeben über