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

Статья
02/26/2024

Подпрограмма 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 задает для указателя, на который указывает Group , значение NULL и игнорирует оставшийся выходной параметр GroupDefaulted.

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Server 2003 с пакетом обновления 1 (SP1)
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также раздел

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID

Share via