RtlCopySid-Funktion (ntifs.h)

Artikel
02/26/2024

Die RtlCopySid-Routine kopiert den Wert eines Sicherheitsbezeichners (SID) in einen Puffer.

Syntax

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

Parameter

[in] DestinationSidLength

Länge (in Bytes) des Puffers, der die Kopie der SID empfangen soll.

[in] DestinationSid

Zeiger auf einen vom Aufrufer zugewiesenen Puffer, um eine Kopie der Quell-SID-Struktur zu empfangen. Der Puffer muss mindestens sizeof(SID) aufweisen.

[in] SourceSid

Zeiger auf die zu kopierende Quell-SID-Struktur.

Rückgabewert

RtlCopySid gibt STATUS_SUCCESS zurück, wenn die SID erfolgreich kopiert wurde. Andernfalls wird ein NTSTATUS-Wert wie einer der folgenden zurückgegeben:

Rückgabecode	Beschreibung
STATUS_BUFFER_TOO_SMALL	Der Puffer DestinationSid war nicht groß genug, um eine Kopie der SID zu empfangen.

Hinweise

Weitere Informationen zur Sicherheit und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und in der Dokumentation zu diesen Themen im Windows SDK.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	<= APC_LEVEL

Weitere Informationen