RtlCreateSecurityDescriptorRelative 函式 (ntifs.h)

發行項
03/01/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 可以傳回下列其中一項：

傳回碼	Description
STATUS_SUCCESS	呼叫已順利完成。
STATUS_UNKNOWN_REVISION	指定的修訂未知或不受支援。

備註

實際上，成功呼叫此例程時，會初始化沒有安全性條件約束的安全性描述元。

如需安全性和訪問控制的詳細資訊，請參閱適用於驅動程序開發人員的 Windows 安全性模型，以及 Windows SDK 中有關這些主題的檔。

規格需求

需求	值
最低支援的用戶端	Windows 2000
目標平台	桌面
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL