LPWSPSENDDISCONNECT-Rückruffunktion (ws2spi.h)

Artikel
03/04/2024

Die LPWSPSendDisconnect-Funktion initiiert das Beenden der Verbindung für den Socket und sendet Trenndaten.

Syntax

LPWSPSENDDISCONNECT Lpwspsenddisconnect;

int Lpwspsenddisconnect(
  [in]  SOCKET s,
  [in]  LPWSABUF lpOutboundDisconnectData,
  [out] LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor, der einen Socket identifiziert.

[in] lpOutboundDisconnectData

Zeiger auf die ausgehenden Verbindungsdaten.

[out] lpErrno

Zeiger auf den Fehlercode.

Rückgabewert

Wenn kein Fehler auftritt, gibt LPWSPSendDisconnect null zurück. Andernfalls wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode ist in lpErrno verfügbar.

Fehlercode	Bedeutung
WSAENETDOWN	Beim Netzwerksubsystem ist ein Fehler aufgetreten.
WSAENOPROTOOPT	Der Parameter lpOutboundDisconnectData ist nicht NULL, und die Verbindungsdaten werden vom Dienstanbieter nicht unterstützt.
WSAEINPROGRESS	Der Windows Sockets-Aufruf wird blockiert, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion.
WSAENOTCONN	Socket ist nicht verbunden (nur verbindungsorientierte Sockets).
WSAENOTSOCK	Der Deskriptor ist kein Socket.
WSAEFAULT	Der parameter lpOutboundDisconnectData ist nicht vollständig in einem gültigen Teil des Benutzeradressraums enthalten.

Hinweise

Die LPWSPSendDisconnect-Funktion wird an verbindungsorientierten Sockets verwendet, um die Übertragung zu deaktivieren und die Beendigung der Verbindung zusammen mit der Übertragung von Verbindungsdaten zu initiieren, falls vorhanden.

Nachdem diese Funktion erfolgreich ausgestellt wurde, werden nachfolgende Senden nicht mehr zugelassen.

Der parameter lpOutboundDisconnectData , wenn nicht NULL, verweist auf einen Puffer, der die ausgehenden Verbindungsdaten enthält, die an die Remotepartei gesendet werden sollen.

Beachten Sie, dass LPWSPSendDisconnect den Socket nicht schließt und dass an den Socket angefügte Ressourcen erst freigegeben werden, wenn LPWSPCloseSocket aufgerufen wird.

Hinweis

Die LPWSPSendDisconnect-Funktion wird unabhängig von der SO_LINGER Einstellung für den Socket nicht blockiert. Ein Windows Sockets SPI-Client sollte sich nicht darauf verlassen, dass ein Socket wiederverwendet werden kann, nachdem die Verbindung getrennt wurde. Insbesondere muss ein Windows Sockets-Anbieter die Verwendung von LPWSPConnect auf einem solchen Socket nicht unterstützen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	ws2spi.h

Weitere Informationen

LPWSPConnect

LPWSPSocket

Freigeben über