InitializeSid-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die InitializeSid-Funktion initialisiert eine Sicherheits-ID (SID).

Syntax

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Parameter

[out] Sid

Ein Zeiger auf eine zu initialisierende SID-Struktur .

[in] pIdentifierAuthority

Ein Zeiger auf eine SID_IDENTIFIER_AUTHORITY Struktur, die in der SID-Struktur festgelegt werden soll.

[in] nSubAuthorityCount

Gibt die Anzahl von Unterautoritäten an, die in der SID festgelegt werden sollen. Die Werte der Unterautorität müssen separat festgelegt werden, wie im folgenden Abschnitt "Hinweise" beschrieben.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Obwohl die InitializeSid-Funktion die Anzahl der Unterautoritäten für die SID festlegt, werden die Unterautoritätswerte nicht festgelegt. Dies muss separat mithilfe von Funktionen wie GetSidSubAuthority erfolgen.

Eine Anwendung kann die AllocateAndInitializeSid-Funktion verwenden, um eine SID zu initialisieren und deren Unterautoritätswerte festzulegen.

Diese Funktion verwendet einen 32-Bit-RID-Wert. Für Anwendungen, die einen größeren RID-Wert erfordern, verwenden Sie CreateWellKnownSid.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll