WsCreateChannelForListener-Funktion (webservices.h)

  • Artikel

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