0 out of 3 rated this helpful - Rate this topic

SetKernelObjectSecurity function

Applies to: desktop apps only

The SetKernelObjectSecurity function sets the security of a kernel object. For example, this can be a process, thread, or event.

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

Minimum supported server

Windows Server 2003

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

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ