WsCloseListener-Funktion (webservices.h)

Artikel
08/27/2023

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

Freigeben über