WsOpenListener-Funktion (webservices.h)

  • Artikel

Initiiert das "Lauschen" für eine angegebene Adresse. Sobald ein Listener geöffnet ist, können Kanäle von diesem akzeptiert werden. Wenn das Öffnen erfolgreich ist, muss der Listener mit der WsCloseListener-Funktion geschlossen werden, bevor Listenerressourcen freigegeben werden können.

Syntax

HRESULT WsOpenListener(
  [in]           WS_LISTENER            *listener,
  [in]           const WS_STRING        *url,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] listener

Ein Zeiger auf das zu öffnende Listener-Objekt . Der Zeiger muss auf ein gültiges WS_LISTENER-Objekt verweisen, und der Wert, auf den verwiesen wird, ist möglicherweise nicht NULL.

[in] url

Ein Zeiger auf ein Objekt, das die URL-Adresszeichenfolge für den Listener enthält.

Hinweis Die URL befindet sich immer in Escapeform. Die URL darf keine Abfragezeichenfolge oder ein Fragment enthalten. Diese URL kann die "+"- oder "*"-Wildcards im Hostnamenteil oder einen Hostnamen oder eine literale IP-Adresse enthalten. Weitere Informationen zur URL finden Sie unter Hinweise.
 

[in, optional] asyncContext

Ein Zeiger auf A WS_ASYNC_CONTEXT -Objekt, das Informationen zum asynchronen Aufrufen der Funktion enthält. Der Wert wird auf NULL festgelegt, wenn synchron aufgerufen wird.

[in, optional] error

Ein Zeiger auf ein WS_ERROR-Objekt , in dem zusätzliche Informationen zum Fehler gespeichert werden sollen, wenn die Funktion fehlschlägt.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
WS_S_ASYNC
 Der asynchrone Vorgang steht noch aus.
WS_E_OPERATION_ABORTED
 Der Listener wurde während des Öffnens oder vor dem Öffnen abgebrochen.
WS_E_INVALID_OPERATION
 Der Listener befindet sich im falschen Zustand.
WS_E_ADDRESS_IN_USE
 Die Adresse wird bereits verwendet.
WS_E_ADDRESS_NOT_AVAILABLE
 Die Adresse ist für diesen Kontext ungültig.
WS_E_QUOTA_EXCEEDED
 Ein Kontingent wurde überschritten.
WS_E_OPERATION_ABORTED
 Der Vorgang wurde abgebrochen.
WS_E_OPERATION_TIMED_OUT
 Der Vorgang wurde innerhalb der zugewiesenen Zeit nicht abgeschlossen.
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.

Hinweise

Wenn Sie IPv6-Adressen verwenden, müssen sie in Klammern im Hostnamenteil eingeschlossen werden.

Weitere Informationen finden Sie unter WS_HTTP_CHANNEL_BINDING.

Bei WS_UDP_CHANNEL_BINDING wird der Pfadteil der URL ignoriert. Wenn eine Literal-IP-Adresse angegeben wird, wird sie zum Lauschen verwendet, andernfalls wird eine Wildcard-IP-Adresse verwendet.

Bei WS_TCP_CHANNEL_BINDING wird der Pfadteil der URL als Präfix mit der empfangenen URL abgeglichen.
Wenn eine Literal-IP-Adresse angegeben wird, wird sie zum Lauschen verwendet, andernfalls wird eine Wildcard-IP-Adresse verwendet.

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