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

  • Статья

Подпрограмма 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 для разработчиков драйверов и в документации по этим темам в Windows SDK.

Требования

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

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

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY