RtlCopySid 函式 (ntifs.h)

RtlCopySid 例程會將安全性標識碼的值複製到緩衝區 (SID) 。

語法

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

[in] DestinationSidLength

要接收 SID 複本之緩衝區的長度，以位元組為單位。

[in] DestinationSid

呼叫端配置的緩衝區指標，以接收來源 SID 結構的複本。緩衝區的大小 必須至少為 (SID) ，

[in] SourceSid

要複製之來源 SID 結構的指標。

如果已成功複製 SID，RtlCopySid 會傳回STATUS_SUCCESS。否則，它會傳回NTSTATUS值，例如下列其中一個：

傳回碼	Description
STATUS_BUFFER_TOO_SMALL	DestinationSid 緩衝區不夠大，無法接收 SID 的複本。

如需安全性和訪問控制的詳細資訊，請參閱適用於驅動程序開發人員的 Windows 安全性模型，以及 Windows SDK 中有關這些主題的檔。

需求	值
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL	<= APC_LEVEL