RtlInitializeSid-Funktion (ntifs.h)

  • Artikel

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