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

Статья
02/07/2025

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

Синтаксис

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

Параметры

[out] Sid

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

[in] IdentifierAuthority

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

[in] SubAuthorityCount

Количество подзаготов, заданных в идентификаторе безопасности. Значения подзаготовки должны быть заданы отдельно, как описано в следующем разделе "Примечания".

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

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

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

Замечания

Хотя RtlInitializeSid задает количество вложенных учетных данных для идентификатора безопасности, оно не задает значения подавторизации. Это необходимо сделать отдельно путем вызова RtlSubAuthoritySid.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe (режим ядра); Ntdll.dll (режим пользователя)
IRQL	< DISPATCH_LEVEL

См. также

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY

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