GetSidSubAuthority-Funktion (securitybaseapi.h)
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 |