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

Статья
03/08/2023

Подпрограмма RtlInitializeSidEx инициализирует предварительно выделенную структуру идентификатора безопасности (SID).

Синтаксис

NTSYSAPI NTSTATUS RtlInitializeSidEx(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount,
        ...                       
);

Параметры

[out] Sid

Указатель на структуру sid, выделенную вызывающим объектом, которую необходимо инициализировать.

[in] IdentifierAuthority

Указатель на структуру SID_IDENTIFIER_AUTHORITY , задается в структуре SID.

[in] SubAuthorityCount

Количество дочерних центров, которые необходимо задать в идентификаторе безопасности.

...

Значения для каждого подчиненного центра. Вызывающий объект должен указать аргумент SubAuthorityCount.

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

Функция RtlInitializeSid возвращает одно из следующих элементов:

Код возврата	Описание
STATUS_SUCCESS	Идентификатор безопасности успешно инициализирован.
STATUS_INVALID_PARAMETER	Указанное значение SubAuthorityCount является недопустимым.

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

Требования

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

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

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY

Share via