Export (0) Print
Expand All
Expand Minimize

RtlCreateSecurityDescriptorRelative routine

The RtlCreateSecurityDescriptorRelative routine initializes a new security descriptor in self-relative format. On return, the security descriptor is initialized with no system ACL (SACL), no discretionary ACL (DACL), no owner, no primary group, and all control flags set to zero.

Syntax


NTSTATUS RtlCreateSecurityDescriptorRelative(
  _Out_  PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  _In_   ULONG Revision
);

Parameters

SecurityDescriptor [out]

Pointer to a caller-allocated buffer, which must be at least sizeof(SECURITY_DESCRIPTOR_RELATIVE), to receive the initialized security descriptor.

Revision [in]

Revision level to assign to the security descriptor. This parameter must be SECURITY_DESCRIPTOR_REVISION.

Return value

RtlCreateSecurityDescriptorRelative can return one of the following:

Return codeDescription
STATUS_SUCCESS

The call completed successfully.

STATUS_UNKNOWN_REVISION

The given Revision is not known or is not supported.

 

Remarks

In effect, a successful call to this routine initializes a security descriptor without security constraints.

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

ACL
RtlCreateSecurityDescriptor
RtlLengthSecurityDescriptor
RtlSetDaclSecurityDescriptor
RtlSetOwnerSecurityDescriptor
RtlValidSecurityDescriptor

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft