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

  • Статья

Подпрограмма 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

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

RtlEqualPrefixSid

RtlequalSid

RtlLengthSid

RtlValidSid

SID