Функция GetSecurityDescriptorGroup (securitybaseapi.h)

Статья
08/25/2023

Функция GetSecurityDescriptorGroup извлекает сведения о первичной группе из дескриптора безопасности.

Синтаксис

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

Параметры

[in] pSecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , основную информацию о группе которой извлекает функция.

[out] pGroup

Указатель на указатель на идентификатор безопасности (SID), который идентифицирует основную группу при возврате функции. Если дескриптор безопасности не содержит основную группу, функция присваивает указателю, на который указывает pGroup, значение NULL и игнорирует оставшийся выходной параметр lpbGroupDefaulted. Если дескриптор безопасности содержит основную группу, функция устанавливает указатель, на который указывает pGroup , на адрес ИД безопасности группы дескриптора безопасности, и предоставляет допустимое значение для переменной, на которую указывает lpbGroupDefaulted.

[out] lpbGroupDefaulted

Указатель на флаг, который задается на значение флага SE_GROUP_DEFAULTED в структуре SECURITY_DESCRIPTOR_CONTROL при возврате функции. Если значение, хранящееся в переменной, на которую указывает параметр pGroup , равно NULL, значение не устанавливается.

Возвращаемое значение

Если функция выполнена успешно, функция возвращает ненулевое значение.

Если функция завершается сбоем, она возвращает ноль. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll