RtlSetGroupSecurityDescriptor 函式（ntifs.h）

發行項
02/07/2025

RtlSetGroupSecurityDescriptor 例程會設定絕對格式安全性描述元的主要群組資訊。它會取代安全性描述元中已存在的任何主要群組資訊。

語法

NTSYSAPI NTSTATUS RtlSetGroupSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Group,
  [in, optional] BOOLEAN              GroupDefaulted
);

參數

[in, out] SecurityDescriptor

要設定主要群組之 SECURITY_DESCRIPTOR 結構的指標。 RtlSetGroupSecurityDescriptor 會將任何現有的主要群組取代為新的主要群組。

[in, optional] Group

安全性描述項新主要擁有者的安全性標識碼（SID）結構的指標。這個指標，而不是 SID 結構本身，會複製到安全性描述元中。如果 GroupNULL，RtlSetGroupSecurityDescriptor 會清除安全性描述項的主要群組資訊。這會將安全性描述元標示為沒有主要群組。

[in, optional] GroupDefaulted

如果主要群組資訊衍生自默認機制，請將此布爾值變數設定為 TRUE。如果此參數 TRUE，RtlSetGroupSecurityDescriptor 會在安全性描述元的 [SECURITY_DESCRIPTOR_CONTROL] 字段中設定SE_GROUP_DEFAULTED旗標。如果此參數 FALSE，RtlSetGroupSecurityDescriptor 會清除SE_GROUP_DEFAULTED旗標。

傳回值

如果主要群組已成功設定或重設，RtlSetGroupSecurityDescriptor 會傳回STATUS_SUCCESS。否則，它會傳回適當的NTSTATUS值，例如下列其中一個：

傳回碼	描述
STATUS_INVALID_SECURITY_DESCR	指定的安全性描述元不是有效的絕對安全性描述元。 STATUS_INVALID_SECURITY_DESCR是錯誤碼。
STATUS_UNKNOWN_REVISION	這個例程無法辨識指定的安全性描述元修訂。 STATUS_UNKNOWN_REVISION是錯誤碼。

言論

若要擷取安全性描述元的主要群組資訊，請使用 RtlGetGroupSecurityDescriptor。

若要設定安全性描述元的擁有者資訊，請使用 RtlSetOwnerSecurityDescriptor。

如需安全性和訪問控制的詳細資訊，請參閱 Microsoft Windows SDK 檔。

要求

要求	價值
最低支援的用戶端	Windows Server 2003 SP1
目標平臺	普遍
標頭	ntifs.h （include Ntifs.h）
連結庫	NtosKrnl.lib
DLL	NtosKrnl.exe （核心模式）：Ntdll.dll （使用者模式）
IRQL	<= APC_LEVEL