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

Weitere Informationen

Zugriffssteuerung

Grundlegende Access Control-Funktionen

FreeSid

GetSidIdentifierAuthority

InitializeSid

SID_IDENTIFIER_AUTHORITY

Bekannte SIDs