SO_WSK_SECURITY

Die Option SO_WSK_SECURITY Sockets ermöglicht es einer WSK-Anwendung, entweder einen Sicherheitsdeskriptor auf einen Socket anzuwenden oder eine zwischengespeicherte Kopie des Sicherheitsdeskriptors eines Sockets aus einem Socket abzurufen. Der Sicherheitsdeskriptor steuert die Freigabe der lokalen Transportadresse, an die der Socket gebunden ist.

Diese Socketoption gilt nur für lauschende Sockets, Datagrammsockets und verbindungsorientierte Sockets.

Wenn eine WSK-Anwendung diese Socketoption verwendet, um einen Sicherheitsdeskriptor auf einen Socket anzuwenden, muss sie dies tun, bevor der Socket an eine lokale Transportadresse gebunden wird.

Um einen Sicherheitsdeskriptor auf einen Socket anzuwenden, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.

Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket-Funktion einen Zeiger auf einen IRP angeben, um einen Sicherheitsdeskriptor auf einen Socket anzuwenden.

Wenn eine WSK-Anwendung diese Socketoption verwendet, um einen Sicherheitsdeskriptor auf einen Socket anzuwenden, ersetzt der neue Sicherheitsdeskriptor alle Sicherheitsbeschreibungen, die zuvor auf den Socket angewendet wurden.

Eine WSK-Anwendung darf die zwischengespeicherte Kopie des Sicherheitsdeskriptors erst nach Abschluss des IRP freigeben.

Eine WSK-Anwendung kann auch einen Sicherheitsdeskriptor auf einen Socket anwenden, wenn der Socket anfänglich erstellt wird, indem beim Aufrufen der WskSocket- oder WskSocketConnect-Funktion ein Zeiger auf eine zwischengespeicherte Kopie eines Sicherheitsdeskriptors im SecurityDescriptor-Parameter angegeben wird.

Wenn eine WSK-Anwendung keinen Sicherheitsdeskriptor auf einen Socket anwendet, verwendet das WSK-Subsystem einen Standardsicherheitsdeskriptor, der die Freigabe der lokalen Transportadresse nicht zulässt.

Um eine zwischengespeicherte Kopie des Sicherheitsdeskriptors eines Sockets aus einem Socket abzurufen, ruft eine WSK-Anwendung die WskControlSocket-Funktion mit den folgenden Parametern auf.

Eine WSK-Anwendung muss beim Aufrufen der WskControlSocket-Funktion einen Zeiger auf einen IRP angeben, um eine zwischengespeicherte Kopie des Sicherheitsdeskriptors eines Sockets aus einem Socket abzurufen.

Eine WSK-Anwendung muss die WskControlClient-Funktion mit dem WSK_RELEASE_SD Steuercode aufrufen, um die zwischengespeicherte Kopie des Sicherheitsdeskriptors freizugeben, wenn sie nicht mehr benötigt wird.

Weitere Informationen finden Sie auf der Referenzseite für die SECURITY_DESCRIPTOR-Struktur .

Requirements (Anforderungen)