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)