GetSecurityDescriptorGroup函数从安全描述符中检索主组信息。
BOOL GetSecurityDescriptorGroup(
PSECURITY_DESCRIPTOR 【pSecurityDescriptor】, | //安全描述符的地址 |
PSID【* PGROUP】, | //指向组安全标识符(SID)的地址 |
LPBOOL 【lpbGroupDefaulted】 | //默认的标志地址 |
); |
参数
【pSecurityDescriptor】
指向功能检索的主组信息的SECURITY_DESCRIPTOR结构。
【PGROUP】
指向指向SID结构的指针,该结构在函数返回时标识主组。(SID是安全标识符。)如果安全描述符不包含主组,则该函数将【PGROUP】指向的指针设置为NULL,并忽略剩余的输出参数【lpbGroupDefaulted】.如果安全描述符包含主组,则该函数将【PGROUP】指向的指针设置为安全描述符组SID结构的地址,并为【lpbGroupDefaulted】指向的变量提供有效值。
【lpbGroupDefaulted】
当函数返回时,将指向一个标志设置为SECURITY_DESCRIPTOR_CONTROL结构中的SE_GROUP_DEFAULTED标志的值。如果存储在【PGROUP】参数指向的变量中的值为NULL,则不设置任何值。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看
GetSecurityDescriptorControl, GetSecurityDescriptorDacl, GetSecurityDescriptorLength, GetSecurityDescriptorOwner, GetSecurityDescriptorSacl, IsValidSecurityDescriptor, SECURITY_DESCRIPTOR, SECURITY_DESCRIPTOR_CONTROL, SetSecurityDescriptorGroup, SID