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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in] DestinationSidLength

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

[in] DestinationSid

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

[in] SourceSid

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

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

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

Код возврата	Описание
STATUS_BUFFER_TOO_SMALL	Буфер DestinationSid не был достаточно велик для получения копии идентификатора безопасности.

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

Требования

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

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