AllocateAndInitializeSid-Funktion (securitybaseapi.h)
Die AllocateAndInitializeSid-Funktion weist einen Sicherheitsbezeichner (SID) mit bis zu acht Unterautoritäten zu und initialisiert diese.
Syntax
BOOL AllocateAndInitializeSid(
[in] PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
[in] BYTE nSubAuthorityCount,
[in] DWORD nSubAuthority0,
[in] DWORD nSubAuthority1,
[in] DWORD nSubAuthority2,
[in] DWORD nSubAuthority3,
[in] DWORD nSubAuthority4,
[in] DWORD nSubAuthority5,
[in] DWORD nSubAuthority6,
[in] DWORD nSubAuthority7,
[out] PSID *pSid
);
Parameter
[in] pIdentifierAuthority
Ein Zeiger auf eine SID_IDENTIFIER_AUTHORITY-Struktur . Diese Struktur stellt den obersten Bezeichnerautoritätswert bereit, der in der SID festgelegt werden soll.
[in] nSubAuthorityCount
Gibt die Anzahl der Unterautoritäten an, die in der SID platziert werden sollen. Dieser Parameter gibt auch an, wie viele der Unterauthority-Parameter über aussagekräftige Werte verfügen. Dieser Parameter muss einen Wert von 1 bis 8 enthalten.
Beispielsweise gibt ein Wert von 3 an, dass die von den Parametern dwSubAuthority0, dwSubAuthority1 und dwSubAuthority2 angegebenen Unterautoritätswerte über aussagekräftige Werte verfügen und den Rest ignorieren.
[in] nSubAuthority0
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority1
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority2
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority3
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority4
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority5
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority6
Unterautoritätswert, der in der SID platziert werden soll.
[in] nSubAuthority7
Unterautoritätswert, der in der SID platziert werden soll.
[out] pSid
Ein Zeiger auf eine Variable, die den Zeiger auf die zugeordnete und initialisierte SID-Struktur empfängt.
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
Eine SID, die der Funktion AllocateAndInitializeSid zugeordnet ist, muss mithilfe der FreeSid-Funktion freigegeben werden.
Diese Funktion erstellt eine SID mit einem 32-Bit-RID-Wert. Für Anwendungen, die längere RID-Werte erfordern, verwenden Sie CreateWellKnownSid.
Beispiele
Ein Beispiel, das diese Funktion verwendet, finden Sie unter Erstellen eines Sicherheitsdeskriptors für ein neues Objekt oder Übernehmen des Objektbesitzes.
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ßlich Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |