SetKernelObjectSecurity function
The SetKernelObjectSecurity function sets the security of a kernel object. For example, this can be a process, thread, or event.
Note This function should not be used when setting a security descriptor on file system objects. Instead, use the SetSecurityInfo or SetNamedSecurityInfo functions.
Syntax
BOOL WINAPI SetKernelObjectSecurity( _In_ HANDLE Handle, _In_ SECURITY_INFORMATION SecurityInformation, _In_ PSECURITY_DESCRIPTOR SecurityDescriptor );
Parameters
- Handle [in]
-
A handle to a kernel object for which security information is set.
- SecurityInformation [in]
-
A set of bit flags that indicate the type of security information to set. This parameter can be a combination of the SECURITY_INFORMATION bit flags.
- SecurityDescriptor [in]
-
A pointer to a SECURITY_DESCRIPTOR structure that contains the new security information.
Return value
If the function succeeds, the function returns nonzero.
If the function fails, it returns zero. To get extended error information, call GetLastError.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Low-level Access Control
- Low-level Access Control Functions
- GetKernelObjectSecurity
- SECURITY_DESCRIPTOR
- SECURITY_INFORMATION
- SetFileSecurity
- SetPrivateObjectSecurity
- SetUserObjectSecurity
Show: