RtlInitializeSid-Funktion (ntifs.h)

Artikel
02/07/2025

Die RtlInitializeSid Routine initialisiert eine Sid-Struktur (Security Identifier).

Syntax

NTSYSAPI NTSTATUS RtlInitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY IdentifierAuthority,
  [in]  UCHAR                     SubAuthorityCount
);

Parameter

[out] Sid

Zeiger auf eine vom Aufrufer zugewiesene SID-Struktur, die initialisiert werden soll.

[in] IdentifierAuthority

Zeigen Sie auf eine SID_IDENTIFIER_AUTHORITY Struktur, die in der SID-Struktur festgelegt werden soll.

[in] SubAuthorityCount

Anzahl der Unterautoritäten, die in der SID festgelegt werden sollen. Unterautoritätswerte müssen separat festgelegt werden, wie im folgenden Abschnitt "Hinweise" beschrieben.

Rückgabewert

RtlInitializeSid gibt eine der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die SID wurde erfolgreich initialisiert.
STATUS_INVALID_PARAMETER	Der angegebene SubAuthorityCount Wert ist ungültig.

Bemerkungen

Obwohl RtlInitializeSid die Anzahl der Unterautoritäten für die SID festlegt, werden die Unterautoritätswerte nicht festgelegt. Dies muss separat erfolgen, indem RtlSubAuthoritySidaufgerufen wird.

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
mindestens unterstützte Client-	Windows 2000
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL-	< DISPATCH_LEVEL

Siehe auch

RtlSubAuthoritySid

SID-

SID_IDENTIFIER_AUTHORITY

Freigeben über