WsCloseListener-Funktion (webservices.h)

  • Artikel

Bewirkt, dass der angegebene Listener die Überwachung beendet.

Syntax

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

Parameter

[in] listener

Zeiger auf eine WS_LISTENER Struktur, die den zu schließenden Listener darstellt.

[in, optional] asyncContext

Zeiger auf eine WS_ASYNC_CONTEXT-Struktur , die Informationen zum asynchronen Aufrufen der Funktion enthält. Übergeben Sie NULL , um die Funktion synchron aufzurufen.

[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
WS_S_ASYNC
 Der asynchrone Vorgang steht noch aus.
WS_E_OPERATION_ABORTED
 Das Schließen wurde durch einen Aufruf von WsAbortListener abgebrochen, da der Listener geschlossen wurde.
WS_E_INVALID_OPERATION
 Der Listener befand sich in einem unangemessenen Zustand.
WS_E_OPERATION_TIMED_OUT
 Der Vorgang wurde nicht innerhalb der zugewiesenen Zeit abgeschlossen.
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

Nachdem der Listener geschlossen wurde, kann der Listener sicher freigegeben werden.

Dieser Vorgang ist für Listener im WS_LISTENER_STATE_OPEN- oder WS_LISTENER_STATE_FAULTED-Zustand zulässig. (Listenerzustände finden Sie in der WS_LISTENER_STATE-Enumeration .)

Wenn ein Listener geschlossen wird, werden alle ausstehenden Versuche, einen Kanal mit der WsAcceptChannel-Methode zu akzeptieren, abgebrochen. WsCloseListener wartet jedoch, bis alle ausstehenden E/A-Vorgänge abgeschlossen sind, bevor der Abschlussvorgang fortgesetzt wird.

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