RtlValidRelativeSecurityDescriptor routine

The RtlValidRelativeSecurityDescriptor routine checks the validity of a self-relative security descriptor.

Syntax


BOOLEAN RtlValidRelativeSecurityDescriptor(
  _In_ PSECURITY_DESCRIPTOR SecurityDescriptorInput,
  _In_ ULONG                SecurityDescriptorLength,
  _In_ SECURITY_INFORMATION RequiredInformation
);

Parameters

SecurityDescriptorInput [in]

A pointer to the buffer that contains the security descriptor in self-relative format. The buffer must begin with a SECURITY_DESCRIPTOR structure, which is followed by the rest of the security descriptor data.

SecurityDescriptorLength [in]

The size of the SecurityDescriptorInput structure.

RequiredInformation [in]

A SECURITY_INFORMATION value that specifies the information that is required to be contained in the security descriptor.

Return value

RtlValidRelativeSecurityDescriptor returns TRUE if the security descriptor is valid and includes the information that the RequiredInformation parameter specifies. Otherwise, this routine returns FALSE.

Remarks

To check the validity of a security descriptor in absolute format, use RtlValidSecurityDescriptor instead.

Requirements

Target platform

Universal

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

<= APC_LEVEL

See also

RtlValidSecurityDescriptor
SECURITY_DESCRIPTOR
SECURITY_INFORMATION

 

 

Send comments about this topic to Microsoft

Show: