RtlSetOwnerSecurityDescriptor
TOC
Collapse the table of content
Expand the table of content

RtlSetOwnerSecurityDescriptor routine

The RtlSetOwnerSecurityDescriptor routine sets the owner information of an absolute-format security descriptor. It replaces any owner information that is already present in the security descriptor.

Syntax


NTSTATUS RtlSetOwnerSecurityDescriptor(
  _Inout_  PSECURITY_DESCRIPTOR SecurityDescriptor,
  _In_opt_ PSID                 Owner,
  _In_opt_ BOOLEAN              OwnerDefaulted
);

Parameters

SecurityDescriptor [in, out]

Pointer to the SECURITY_DESCRIPTOR structure whose owner is to be set. RtlSetOwnerSecurityDescriptor replaces any existing owner with the new owner.

Owner [in, optional]

Pointer to a security identifier (SID) structure for the security descriptor's new primary owner. This pointer, not the SID structure itself, is copied into the security descriptor. If this parameter is NULL, RtlSetOwnerSecurityDescriptor clears the security descriptor's owner information. This marks the security descriptor as having no owner.

OwnerDefaulted [in, optional]

Set to TRUE if the owner information is derived from a default mechanism. If this value is TRUE, it is default information. RtlSetOwnerSecurityDescriptor sets the SE_OWNER_DEFAULTED flag in the security descriptor's SECURITY_DESCRIPTOR_CONTROL field. If this parameter is FALSE, the SE_OWNER_DEFAULTED flag is cleared.

Return value

RtlSetOwnerSecurityDescriptor can return one of the following status codes:

Return codeDescription
STATUS_SUCCESS

The owner was successfully set or reset.

STATUS_UNKNOWN_REVISION

The given security descriptor's version is not recognized by this routine.

STATUS_INVALID_SECURITY_DESCR

The given security descriptor is not a valid absolute security descriptor.

 

Remarks

For more information about security and access control, see the documentation on these topics in the Microsoft Windows SDK.

Requirements

Target platform

Universal

Header

Ntifs.h (include Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

< DISPATCH_LEVEL

See also

RtlCreateSecurityDescriptor
RtlCreateSecurityDescriptorRelative
RtlLengthSecurityDescriptor
RtlSetDaclSecurityDescriptor
RtlValidSecurityDescriptor
SeAssignSecurity
SECURITY_DESCRIPTOR
SECURITY_DESCRIPTOR_CONTROL
SID

 

 

Send comments about this topic to Microsoft

Show:
© 2016 Microsoft