RtlCopySid 函数 (ntifs.h)

RtlCopySid 例程将安全标识符的值 (SID) 复制到缓冲区。

语法

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

parameters

[in] DestinationSidLength

要接收 SID 副本的缓冲区的长度(以字节为单位)。

[in] DestinationSid

指向调用方分配的缓冲区的指针,用于接收源 SID 结构的副本。 缓冲区的大小 必须至少为 (SID) ,

[in] SourceSid

指向要复制的源 SID 结构的指针。

返回值

如果成功复制 SID,RtlCopySid 将返回STATUS_SUCCESS。 否则,它将返回一个 NTSTATUS 值,如以下值之一:

返回代码 说明
STATUS_BUFFER_TOO_SMALL
DestinationSid 缓冲区不够大,无法接收 SID 的副本。

注解

有关安全性和访问控制的详细信息,请参阅 面向驱动程序开发人员的 Windows 安全模型 以及 Windows SDK 中有关这些主题的文档。

要求

   
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL <= APC_LEVEL

请参阅

RtlEqualPrefixSid

RtlEqualSid

RtlLengthSid

RtlValidSid

SID