RtlCopySid function (ntifs.h)

The RtlCopySid routine copies the value of a security identifier (SID) to a buffer.

Syntax

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

[in] DestinationSidLength

Length, in bytes, of the buffer to receive the copy of the SID.

[in] DestinationSid

Pointer to a caller-allocated buffer to receive a copy of the source SID structure. The buffer must be at least sizeof(SID),

[in] SourceSid

Pointer to the source SID structure to be copied.

RtlCopySid returns STATUS_SUCCESS if the SID was successfully copied. Otherwise, it returns an NTSTATUS value such as one of the following:

Return code	Description
STATUS_BUFFER_TOO_SMALL	The DestinationSid buffer was not large enough to receive a copy of the SID.

For more information about security and access control, see Windows security model for driver developers and the documentation on these topics in the Windows SDK.

Requirement	Value
Target Platform	Universal
Header	ntifs.h (include Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe (kernel mode); Ntdll.dll (user mode)
IRQL	<= APC_LEVEL