RtlValidRelativeSecurityDescriptor function (wdm.h)
The RtlValidRelativeSecurityDescriptor routine checks the validity of a self-relative security descriptor.
Syntax
NTSYSAPI BOOLEAN RtlValidRelativeSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR SecurityDescriptorInput,
[in] ULONG SecurityDescriptorLength,
[in] SECURITY_INFORMATION RequiredInformation
);
Parameters
[in] SecurityDescriptorInput
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.
[in] SecurityDescriptorLength
The size of the SecurityDescriptorInput structure.
[in] RequiredInformation
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
| Requirement | Value |
|---|---|
| Minimum supported client | Available starting with Windows 2000. |
| Target Platform | Universal |
| Header | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |