GetSecurityDescriptorGroup 函数 (securitybaseapi.h)
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 |