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
);
Parameters
[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.
Return value
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 |
---|---|
|
The DestinationSid buffer was not large enough to receive a copy of the SID. |
Remarks
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.
Requirements
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 |