Export (0) Print
Expand All
Expand Minimize

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

Version

This routine is available on Microsoft Windows 2000 and later.

Header

Ntifs.h (include Ntifs.h)

Library

Ntoskrnl.lib

IRQL

PASSIVE_LEVEL

See also

RtlCreateSecurityDescriptor
RtlLengthSecurityDescriptor
RtlSetDaclSecurityDescriptor
RtlSetOwnerSecurityDescriptor
RtlValidSecurityDescriptor
SECURITY_DESCRIPTOR
SID

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft