RtlCreateSecurityDescriptorRelative 函数 (ntifs.h)

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

语法

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

参数

[out] SecurityDescriptor

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

[in] Revision

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

返回值

RtlCreateSecurityDescriptorRelative 可以返回以下项之一:

返回代码 描述
STATUS_SUCCESS
调用成功完成。
STATUS_UNKNOWN_REVISION
给定 修订 未知或不受支持。

言论

实际上,成功调用此例程会初始化安全描述符,而不受安全约束。

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

要求

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

另请参阅

ACL

RtlCreateSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlSetOwnerSecurityDescriptor

RtlValidSecurityDescriptor