RtlInitializeSid-Funktion (ntifs.h)

Artikel
02/29/2024

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

Zeiger 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 Mitbemerkungen beschrieben.

Rückgabewert

RtlInitializeSid gibt eine der folgenden Rückgaben zurück:

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

Hinweise

Obwohl RtlInitializeSid die Anzahl der Unterautoritäten für die SID festlegt, werden die Unterautoritätswerte nicht festgelegt. Dies muss separat durch Aufrufen von RtlSubAuthoritySid erfolgen.

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
Unterstützte Mindestversion (Client)	Windows 2000
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe (Kernelmodus); Ntdll.dll (Benutzermodus)
IRQL	< DISPATCH_LEVEL

Weitere Informationen

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY

Freigeben über