SO_CONDITIONAL_ACCEPT Socketoption

Die SO_CONDITIONAL_ACCEPT Socketoption ist so konzipiert, dass eine Anwendung entscheiden kann, ob eine eingehende Verbindung auf einem Lauschocket akzeptiert werden soll oder nicht.

Wert der Socketoption

Die Konstante, die diese Socketoption darstellt, ist 0x3002.

Syntax

int setsockopt(
  (SOCKET) s,      // descriptor identifying a socket 
  (int) SOL_SOCKET,   // level
  (int) SO_CONDITIONAL_ACCEPT, // optname
  (char *) optval,         // input buffer,
  (int) optlen,       // size of input buffer
);

Parameter

s [in]

Ein Deskriptor, der den Socket identifiziert.

Ebene [in]

Die Ebene, auf der die Option definiert ist. Verwenden Sie für diesen Vorgang SOL_SOCKET .

optname [in]

Die Socketoption, für die der Wert festgelegt werden soll. Verwenden Sie für diesen Vorgang SO_CONDITIONAL_ACCEPT .

optval [out]

Ein Zeiger auf den Puffer, der den Wert für die festzulegende Option enthält. Dieser Parameter sollte auf einen Puffer zeigen, der der Größe eines DWORD-Werts entspricht oder größer ist.

Dieser Wert wird als boolescher Wert behandelt, wobei 0 verwendet wird, um FALSE (deaktiviert) anzugeben, und ein nonzero-Wert, um TRUE (aktiviert) anzugeben.

optlen [in, out]

Ein Zeiger auf die Größe des Optval-Puffers in Bytes. Diese Größe muss gleich oder größer als die Größe eines DWORD-Werts sein.

Rückgabewert

Wenn der Vorgang erfolgreich abgeschlossen wurde, gibt setsockopt null zurück.

Wenn der Vorgang fehlschlägt, wird der Wert SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode kann durch Aufrufen von WSAGetLastError abgerufen werden.

Fehlercode	Bedeutung
WSANOTINITIALISED	Vor der Verwendung dieser Funktion muss ein erfolgreicher WSAStartup-Aufruf erfolgen.
WSAENETDOWN	Beim Netzwerksubsystem ist ein Fehler aufgetreten.
WSAEFAULT	Einer der optval - oder optlen-Parameter verweist auf den Speicher, der sich nicht in einem gültigen Teil des Benutzeradressraums befindet. Dieser Fehler wird auch zurückgegeben, wenn der Wert, auf den der optlen-Parameter verweist, kleiner als die Größe eines DWORD-Werts ist.
WSAEINPROGRESS	Ein blockierter Windows Sockets 1.1-Aufruf wird ausgeführt, oder der Dienstanbieter verarbeitet weiterhin eine Rückruffunktion.
WSAEINVAL	Der Levelparameter ist unbekannt oder ungültig. Dieser Fehler wird auch zurückgegeben, wenn sich der Socket bereits im Lauschzustand befand.
WSAENOPROTOOPT	Die Option ist unbekannt oder wird von der angegebenen Protokollfamilie nicht unterstützt.
WSAENOTSOCK	Der Deskriptor ist kein Socket.

 

Bemerkungen

Die setockopt-Funktion , die mit der SO_CONDITIONAL_ACCEPT Socketoption aufgerufen wird, ermöglicht es einer Anwendung zu entscheiden, ob eine eingehende Verbindung auf einem Lauschocket akzeptiert werden soll oder nicht. Die Option "Bedingtes Akzeptieren" für einen Socket ist standardmäßig deaktiviert (auf FALSE festgelegt).

Wenn diese Socketoption aktiviert ist, akzeptiert der TCP-Stapel keine Verbindungen automatisch. Es wartet, bis die Anwendung angibt, dass sie die Verbindung über den mit der WSAAccept-Funktion registrierten bedingten Annehmen-Rückruf akzeptiert. Sobald eine Verbindungsanforderung empfangen wurde, ruft Winsock den von der Anwendung registrierten Rückruf der bedingten Annahme auf. Nur wenn der Rückruf der bedingten Annahme CF_ACCEPT zurückgibt, benachrichtigt Winsock den Transport, um die Verbindung vollständig zu akzeptieren.

Wenn die SO_CONDITIONAL_ACCEPT Socketoption auf aktiviert (auf TRUE festgelegt) festgelegt ist, hat dies mehrere Nebenwirkungen auf den Socket:

• Dadurch wird der integrierte SYN-Angriffsschutz des TCP-Stapels deaktiviert, da die Anwendung jetzt den Besitz für die Annahme von Verbindungen übernimmt.
• Dadurch wird das Listenbacklog effektiv deaktiviert, da Verbindungen im Namen eines Abhörsockets nicht akzeptiert werden. Eine Verbindung wird nie vollständig akzeptiert, bis die Anwendung die Verwendung des CF_ACCEPT-Mechanismus vollständig akzeptiert.
• Dies bedeutet auch, dass die Anwendung darauf achtet, sich immer in einem Zustand zu befinden, um die Rückrufe zur Annahme der Verbindung problemlos zu verarbeiten. Wenn die Anwendung mit anderen Verarbeitungsvorgängen beschäftigt ist, kann die Clientseite ein Timeout ausführen, bevor die Anwendung die Verbindung tatsächlich akzeptiert. Dies führt zu einer schlechten Clienterfahrung.

Im Allgemeinen besteht der Standard Grund, warum Anwendungen bedingte Akzeptanz verwenden, darin, die Quell-IP-Adresse oder den port zu überprüfen, die vom verbindenden Client verwendet wird, und dann entscheiden, die Verbindung zu akzeptieren oder abzulehnen. Anwendungen werden jedoch wahrscheinlich besser funktionieren, wenn die Option SO_CONDITIONAL_ACCEPT nicht aktiviert ist und die Anwendung den TCP-Stapel und das Listenbacklog wie erwartet funktioniert. Wenn die Anwendung dann die akzeptierte Verbindung verarbeitet, kann die Anwendung einfach den Socket schließen, wenn sie von einer falschen IP-Quelladresse oder einem falschen Port stammt. Der Sicherheitsnachteil dieses Verhaltens besteht darin, dass der Client jetzt bestätigt hat, dass die Anwendung eine IP-Adresse und einen Port lauscht, da die zuvor akzeptierte Verbindung gewaltsam geschlossen wurde. Die Nachteile bei der Aktivierung SO_CONDITIONAL_ACCEPT jedoch im Allgemeinen überwiegen diese Einschränkung.

Die getockopt-Funktion , die mit der Socketoption SO_CONDITIONAL_ACCEPT aufgerufen wird, ermöglicht einer Anwendung das Abrufen des aktuellen Zustands der Option für bedingte Akzeptanz, obwohl dies normalerweise nicht verwendet wird. Wenn eine Anwendung die bedingte Annahme für einen Socket aktivieren muss, ruft sie just die setockopt-Funktion auf, um die Option zu aktivieren.

Beachten Sie, dass die Ws2def.h-Headerdatei automatisch in Winsock2.h enthalten ist und nie direkt verwendet werden sollte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	Ws2def.h (einschließlich Winsock2.h)

Siehe auch

getsockopt

setsockopt

WSAAccept