WSK_CACHE_SD
A WSK application uses the WSK_CACHE_SD client control operation to obtain a cached copy of a security descriptor that can be passed to the WskSocket, WskSocketConnect, and WskControlSocket functions.
To obtain a cached copy of a security descriptor, a WSK application calls the WskControlClient function with the following parameters.
Parameter | Value |
---|---|
ControlCode |
WSK_CACHE_SD |
InputSize |
sizeof(PSECURITY_DESCRIPTOR) |
InputBuffer |
A pointer to a PSECURITY_DESCRIPTOR-typed variable. This variable contains a pointer to the SECURITY_DESCRIPTOR structure that defines the uncached security descriptor that is being cached. |
OutputSize |
sizeof(PSECURITY_DESCRIPTOR) |
OutputBuffer |
A pointer to a PSECURITY_DESCRIPTOR-typed variable. This variable receives a pointer to a SECURITY_DESCRIPTOR structure that describes the cached security descriptor. |
OutputSizeReturned |
NULL |
Irp |
NULL |
A WSK application must release the cached copy of the security descriptor by using the WSK_RELEASE_SD client control operation when the security descriptor is no longer needed.
See the reference page for the SECURITY_DESCRIPTOR structure for more information.
The Irp parameter must be NULL for this client control operation.
Requirements
Version |
Available in Windows Vista and later versions of the Windows operating systems. |
Header |
Wsk.h (include Wsk.h) |