GetSecurityDescriptorGroup 函数 (securitybaseapi.h)

项目
03/01/2024

GetSecurityDescriptorGroup 函数从安全描述符检索主要组信息。

语法

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

参数

[in] pSecurityDescriptor

指向函数检索其主组信息的 SECURITY_DESCRIPTOR 结构的指针。

[out] pGroup

指向安全标识符的指针 (SID) ，该 SID 在函数返回时标识主组。如果安全描述符不包含主组，则该函数将 pGroup 指向的指针设置为 NULL ，并忽略剩余的输出参数 lpbGroupDefaulted。如果安全描述符包含主组，则函数将 pGroup 指向的指针设置为安全描述符组 SID 的地址，并为 lpbGroupDefaulted 指向的变量提供有效值。

[out] lpbGroupDefaulted

指向标志的指针，该标志在函数返回时设置为 SECURITY_DESCRIPTOR_CONTROL 结构中的 SE_GROUP_DEFAULTED 标志的值。如果 pGroup 参数指向的变量中存储的值为 NULL，则不设置任何值。

返回值

如果函数成功，该函数将返回非零值。

如果函数失败，则返回零。要获得更多的错误信息，请调用 GetLastError。

要求

要求	值
最低受支持的客户端	Windows XP [桌面应用 \| UWP 应用]
最低受支持的服务器	Windows Server 2003 [桌面应用 \| UWP 应用]
目标平台	Windows
标头	securitybaseapi.h (包括 Windows.h)
Library	Advapi32.lib
DLL	Advapi32.dll