RtlCopySid 函数 (ntifs.h)

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

语法

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

参数

[in] DestinationSidLength

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

[in] DestinationSid

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

[in] SourceSid

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

返回值

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

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

言论

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

要求

要求 价值
目标平台 普遍
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe(内核模式):Ntdll.dll(用户模式)
IRQL <= APC_LEVEL

另请参阅

RtlEqualPrefixSid

RtlEqualSid

RtlLengthSid

RtlValidSid

SID