Freigeben über


InitializeSid-Funktion (securitybaseapi.h)

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

Weitere Informationen

Zugriffssteuerung Übersicht

AllocateAndInitializeSid

Grundlegende Access Control-Funktionen

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

IsValidSid

SID

SID_IDENTIFIER_AUTHORITY