RtlCreateSecurityDescriptorRelative 函数 (ntifs.h)

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

另请参阅

ACL

RtlCreateSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlSetOwnerSecurityDescriptor

RtlValidSecurityDescriptor