SO_WSK_SECURITY

Med alternativet SO_WSK_SECURITY socket kan ett WSK-program antingen tillämpa en säkerhetsbeskrivning på en socket eller hämta en cachelagrad kopia av en sockets säkerhetsbeskrivning från en socket. Säkerhetsbeskrivningen styr delning av den lokala transportadress som socketen är bunden till.

Det här socketalternativet gäller endast för lyssningsuttag, datagramsocket och anslutningsorienterade socketar.

Om ett WSK-program använder det här socketalternativet för att tillämpa en säkerhetsbeskrivning på en socket måste det göra det innan socketen är bunden till en lokal transportadress.

För att tillämpa en säkerhetsbeskrivning på en socket anropar ett WSK-program funktionen WskControlSocket med följande parametrar.

Parameter	Värde
RequestType	WskSetOption
ControlCode	SO_WSK_SECURITY
nivå	SOL_SOCKET
InputSize	sizeof(PSECURITY_DESCRIPTOR)
InputBuffer	En pekare till en PSECURITY_DESCRIPTOR-typad variabel. Den här variabeln måste innehålla en pekare till en cachelagrad kopia av en säkerhetsbeskrivning som hämtades genom att anropa funktionen WskControlClient med WSK_CACHE_SD-kontrollkoden.
OutputSize	0
OutputBuffer	NOLL
OutputSizeReturned	NOLL

Ett WSK-program måste ange en pekare till en IRP när du anropar funktionen WskControlSocket för att tillämpa en säkerhetsbeskrivning på en socket.

Om ett WSK-program använder det här socketalternativet för att tillämpa en säkerhetsbeskrivning på en socket ersätter den nya säkerhetsbeskrivningen alla säkerhetsbeskrivningar som tidigare tillämpades på socketen.

Ett WSK-program får inte släppa den cachelagrade kopian av säkerhetsbeskrivningen förrän efter att IRP har slutförts.

Ett WSK-program kan också tillämpa en säkerhetsbeskrivning på en socket när socketen skapas först genom att ange en pekare till en cachelagrad kopia av en säkerhetsbeskrivning i parametern SecurityDescriptor när den anropar WskSocket eller WskSocketConnect-funktionen.

Om ett WSK-program inte tillämpar en säkerhetsbeskrivning på en socket använder WSK-undersystemet en standardsäkerhetsbeskrivning som inte tillåter delning av den lokala transportadressen.

Om du vill hämta en cachelagrad kopia av en sockets säkerhetsbeskrivning från en socket anropar ett WSK-program funktionen WskControlSocket med följande parametrar.

Parameter	Värde
RequestType	WskGetOption
ControlCode	SO_WSK_SECURITY
nivå	SOL_SOCKET
InputSize	0
InputBuffer	NOLL
OutputSize	sizeof(PSECURITY_DESCRIPTOR)
OutputBuffer	En pekare till en PSECURITY_DESCRIPTOR-typad variabel. Den här variabeln tar emot en pekare till en cachelagrad kopia av socketens säkerhetsbeskrivning.
OutputSizeReturned	NOLL

Ett WSK-program måste ange en pekare till en IRP när du anropar funktionen WskControlSocket för att hämta en cachelagrad kopia av en sockets säkerhetsbeskrivning från en socket.

Ett WSK-program måste anropa funktionen WskControlClient med WSK_RELEASE_SD-kontrollkoden för att frigöra den cachelagrade kopian av säkerhetsbeskrivningen när den inte längre behövs.

Mer information finns på referenssidan för SECURITY_DESCRIPTOR struktur.

Krav

Version	Finns i Windows Vista och senare versioner av Windows-operativsystemen.
Rubrik	Wsk.h (inkludera Wsk.h)