RtlCopySid-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlCopySid Routine kopiert den Wert einer Sicherheits-ID (SID) in einen Puffer.

Syntax

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

Parameter

[in] DestinationSidLength

Länge des Puffers in Bytes, um die Kopie der SID zu empfangen.

[in] DestinationSid

Zeigen Sie auf einen vom Aufrufer zugewiesenen Puffer, um eine Kopie der Quell-SID-Struktur zu erhalten. Der Puffer muss mindestens Größe von(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 zurückgegeben, z. B. einen der folgenden:

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

Bemerkungen

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

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL-	<= APC_LEVEL

Siehe auch

Freigeben über