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 |