GetSidSubAuthority-Funktion (securitybaseapi.h)

Artikel
03/01/2024

Die GetSidSubAuthority-Funktion gibt einen Zeiger auf eine angegebene Unterautorität in einer Sicherheits-ID (SID) zurück. Der Unterautoritätswert ist ein relativer Bezeichner (RID).

Syntax

PDWORD GetSidSubAuthority(
  [in] PSID  pSid,
  [in] DWORD nSubAuthority
);

Parameter

[in] pSid

Ein Zeiger auf die SID-Struktur , von der ein Zeiger auf eine Unterautorität zurückgegeben werden soll.

Diese Funktion verarbeitet keine gültigen SID-Strukturen . Rufen Sie die IsValidSid-Funktion auf, um zu überprüfen, ob die SID-Struktur gültig ist, bevor Sie diese Funktion aufrufen.

[in] nSubAuthority

Gibt einen Indexwert an, der das Unterautoritätsarrayelement identifiziert, dessen Adresse die Funktion zurückgibt. Die Funktion führt keine Validierungstests für diesen Wert aus. Eine Anwendung kann die GetSidSubAuthorityCount-Funktion aufrufen, um den Bereich der zulässigen Werte zu ermitteln.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf die angegebene SID-Unterautorität . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Wenn die Funktion fehlschlägt, ist der Rückgabewert nicht definiert. Die Funktion schlägt fehl, wenn die angegebene SID-Struktur ungültig ist oder wenn der vom nSubAuthority-Parameter angegebene Indexwert außerhalb der Grenzen liegt.

Hinweise

Die in pSid angegebene SID-Struktur verwendet einen 32-Bit-RID-Wert. Für Anwendungen, die längere RID-Werte erfordern, verwenden Sie CreateWellKnownSid und zugehörige Funktionen.

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