SetSecurityDescriptorGroup 函式 (securitybaseapi.h)

發行項
03/05/2024

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

語法

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

參數

[in, out] pSecurityDescriptor

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

[in, optional] pGroup

安全性描述項新主要群組之 SID 結構的指標。 SID 結構是由安全性描述元所參考，而不是複製到中。如果此參數為 NULL，函式會清除安全性描述項的主要群組資訊。這會將安全性描述符標示為沒有主要群組。

[in] bGroupDefaulted

指出主要群組資訊是否衍生自默認機制。如果此值為 TRUE，則為預設資訊，且函式會將此值儲存為SECURITY_DESCRIPTOR_CONTROL結構中的 SE_GROUP_DEFAULTED 旗標。如果此參數為零，則會清除SE_GROUP_DEFAULTED旗標。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

需求	值
最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	securitybaseapi.h (包括 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll