RtlGetOwnerSecurityDescriptor routine

The RtlGetOwnerSecurityDescriptor routine returns the owner information for a given security descriptor.

Syntax


NTSTATUS RtlGetOwnerSecurityDescriptor(
  _In_  PSECURITY_DESCRIPTOR SecurityDescriptor,
  _Out_ PSID                 *Owner,
  _Out_ PBOOLEAN             OwnerDefaulted
);

Parameters

SecurityDescriptor [in]

Pointer to the security descriptor.

Owner [out]

Pointer to an address to receive a pointer to the owner security identifier (SID). If the security descriptor does not currently contain an owner SID, Owner receives NULL.

OwnerDefaulted [out]

Pointer to a Boolean variable that receives TRUE if the owner information is derived from a default mechanism, rather than by the original provider of the security descriptor explicitly, FALSE otherwise. Valid only if Owner receives a non-NULL value.

Return value

RtlGetOwnerSecurityDescriptor returns STATUS_SUCCESS or an appropriate NTSTATUS value such as one of the following:

Return codeDescription
STATUS_UNKNOWN_REVISION

The security descriptor's revision level is not known or is not supported. This is an error code.

 

Remarks

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

Requirements

Target platform

Universal

Version

This routine is available on Microsoft Windows 2000 and later.

Header

Ntifs.h (include Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

PASSIVE_LEVEL

See also

RtlCreateSecurityDescriptor
RtlLengthSecurityDescriptor
RtlSetDaclSecurityDescriptor
RtlSetOwnerSecurityDescriptor
RtlValidSecurityDescriptor
SECURITY_DESCRIPTOR
SID

 

 

Send comments about this topic to Microsoft

Show: