Expand Minimize

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

Winbase.h (include Windows.h)

Library

Advapi32.lib

DLL

Advapi32.dll

See also

Low-level Access Control
Low-level Access Control Functions
GetKernelObjectSecurity
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetFileSecurity
SetPrivateObjectSecurity
SetUserObjectSecurity

 

 

Community Additions

ADD
Show:
© 2014 Microsoft