Функция RtlGetGroupSecurityDescriptor (ntifs.h)

Статья
02/07/2025

подпрограмма RtlGetGroupSecurityDescriptor возвращает основную информацию о группе для заданного дескриптора безопасности.

Синтаксис

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Параметры

[in] SecurityDescriptor

Указатель на дескриптор безопасности, основной сведения о группе которого должны быть возвращены.

[out] Group

Указатель на переменную, которая получает указатель на идентификатор безопасности (sid) для основной группы. Если дескриптор безопасности не содержит основную группу, *Group получает NULL.

[out] GroupDefaulted

Указатель на логическую переменную, которая получает значение флага SE_GROUP_DEFAULTED в SECURITY_DESCRIPTOR_CONTROL структуре дескриптора безопасности. Это значение допустимо, только если *Group получает значение, отличное отNULL.

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

RtlGetGroupSecurityDescriptor возвращает STATUS_SUCCESS или соответствующее значение NTSTATUS, например следующее:

Возвращаемый код	Описание
STATUS_UNKNOWN_REVISION	Уровень редакции дескриптора безопасности не известен или не поддерживается. Это код ошибки.

Замечания

Если дескриптор безопасности, на который указывает SecurityDescriptor содержит основную группу, RtlGetGroupSecurityDescriptor задает указатель, на который указывает группа Group на адрес идентификатора группы дескриптора безопасности и задает переменную, на которую указывает GroupDefaulted допустимое значение.

Если дескриптор безопасности, на который указывает SecurityDescriptor, не содержит основную группу, RtlGetGroupSecurityDescriptor задает указатель, на который указывает группа значение NULL и игнорирует оставшийся выходной параметр, GroupDefaulted.

Чтобы задать сведения о основной группе для дескриптора безопасности, используйте RtlSetGroupSecurityDescriptor.

Чтобы получить сведения о владельце для дескриптора безопасности, используйте RtlGetOwnerSecurityDescriptor.

Дополнительные сведения о безопасности и управлении доступом см. в документации по пакету SDK для Microsoft Windows.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Server 2003 с пакетом обновления 1 (SP1)
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID

Поделиться через