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

Статья
02/26/2024

Подпрограмма RtlSetGroupSecurityDescriptor задает сведения о основной группе дескриптора безопасности абсолютного формата. Он заменяет все сведения о первичной группе, которые уже присутствуют в дескрипторе безопасности.

Синтаксис

NTSYSAPI NTSTATUS RtlSetGroupSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Group,
  [in, optional] BOOLEAN              GroupDefaulted
);

Параметры

[in, out] SecurityDescriptor

Указатель на структуру SECURITY_DESCRIPTOR , основную группу которой необходимо задать. RtlSetGroupSecurityDescriptor заменяет любую существующую первичную группу новой первичной группой.

[in, optional] Group

Указатель на структуру идентификатора безопасности (SID) для нового основного владельца дескриптора безопасности. Этот указатель, а не сама структура sid, копируется в дескриптор безопасности. Если group имеет значение NULL, RtlSetGroupSecurityDescriptor очищает сведения о основной группе дескриптора безопасности. Это помечает дескриптор безопасности как не имеющий основной группы.

[in, optional] GroupDefaulted

Задайте для этой логической переменной значение TRUE , если сведения о основной группе являются производными от механизма по умолчанию. Если этот параметр имеет значение TRUE, RtlSetGroupSecurityDescriptor устанавливает флаг SE_GROUP_DEFAULTED в поле SECURITY_DESCRIPTOR_CONTROL дескриптора безопасности. Если этот параметр имеет значение FALSE, RtlSetGroupSecurityDescriptor очищает флаг SE_GROUP_DEFAULTED.

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

RtlSetGroupSecurityDescriptor возвращает STATUS_SUCCESS, если основная группа была успешно настроена или сброшена. В противном случае возвращается соответствующее значение NTSTATUS, например одно из следующих значений:

Код возврата	Описание
STATUS_INVALID_SECURITY_DESCR	Данный дескриптор безопасности не является допустимым абсолютным дескриптором безопасности. STATUS_INVALID_SECURITY_DESCR — это код ошибки.
STATUS_UNKNOWN_REVISION	Редакция данного дескриптора безопасности не распознается этой подпрограммой. STATUS_UNKNOWN_REVISION — это код ошибки.

Требования

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

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

RtlGetGroupSecurityDescriptor

RtlSetOwnerSecurityDescriptor

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SID