RtlCreateSecurityDescriptorRelative 函数 (ntifs.h)

项目
02/26/2024

RtlCreateSecurityDescriptorRelative 例程以自相对格式初始化新的安全描述符。返回时，安全描述符初始化时没有系统 ACL (SACL) ，没有任意 ACL (DACL) ，没有所有者，没有主组，并且所有控制标志都设置为零。

语法

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

参数

[out] SecurityDescriptor

指向调用方分配的缓冲区的指针，该缓冲区 的大小必须至少 为 (SECURITY_DESCRIPTOR_RELATIVE) ，才能接收初始化的安全描述符。

[in] Revision

要分配给安全描述符的修订级别。此参数必须SECURITY_DESCRIPTOR_REVISION。

返回值

RtlCreateSecurityDescriptorRelative 可以返回下列值之一：

返回代码	说明
STATUS_SUCCESS	已成功完成调用。
STATUS_UNKNOWN_REVISION	给定的修订版未知或不受支持。

注解

实际上，成功调用此例程会初始化没有安全约束的安全描述符。

有关安全性和访问控制的详细信息，请参阅面向驱动程序开发人员的 Windows 安全模型以及 Windows SDK 中有关这些主题的文档。

要求

要求	值
最低受支持的客户端	Windows 2000
目标平台	桌面
标头	ntifs.h (包括 Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL