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

Статья
02/07/2025

Программа RtlCopySid копирует значение идентификатора безопасности (SID) в буфер.

Синтаксис

NTSYSAPI NTSTATUS RtlCopySid(
  [in] ULONG DestinationSidLength,
  [in] PSID  DestinationSid,
  [in] PSID  SourceSid
);

Параметры

[in] DestinationSidLength

Длина буфера в байтах для получения копии идентификатора безопасности.

[in] DestinationSid

Указатель на выделенный вызывающим буфером для получения копии исходной структуры SID. Буфер должен быть по крайней мере размер(SID),

[in] SourceSid

Указатель на структуру исходного идентификатора безопасности для копирования.

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

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

Возвращаемый код	Описание
STATUS_BUFFER_TOO_SMALL	Буфер DestinationSid был недостаточно большим, чтобы получить копию идентификатора безопасности.

Замечания

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

Требования

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

См. также

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