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

Weitere Informationen

Zugriffssteuerung Übersicht

Grundlegende Access Control-Funktionen

CreateWellKnownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthorityCount

IsValidSid

SID