RtlInitializeSidEx-Funktion (ntifs.h)

Artikel
02/26/2024

Die RtlInitializeSidEx-Routine initialisiert eine vorab zugewiesene Sid-Struktur (Security Identifier).

Syntax

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

Parameter

[out] Sid

Zeiger auf eine vom Aufrufer zugeordnete 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 untergeordneten Autoritäten, die in der SID festgelegt werden sollen.

...

Die Werte, die für jede Unterautorität festgelegt werden sollen. Der Aufrufer muss das Argument SubAuthorityCount angeben.

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

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 10
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Weitere Informationen

RtlSubAuthoritySid

SID

SID_IDENTIFIER_AUTHORITY

Freigeben über