GetSecurityDescriptorGroup-Funktion (securitybaseapi.h)

Artikel
03/04/2024

Die GetSecurityDescriptorGroup-Funktion ruft die Informationen der primären Gruppe aus einem Sicherheitsdeskriptor ab.

Syntax

BOOL GetSecurityDescriptorGroup(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] PSID                 *pGroup,
  [out] LPBOOL               lpbGroupDefaulted
);

Parameter

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, deren primäre Gruppeninformationen die Funktion abruft.

[out] pGroup

Ein Zeiger auf einen Zeiger auf eine Sicherheits-ID (SID), die die primäre Gruppe identifiziert, wenn die Funktion zurückgegeben wird. Wenn der Sicherheitsdeskriptor keine primäre Gruppe enthält, legt die Funktion den Zeiger, auf den pGroup zeigt, auf NULL fest und ignoriert den verbleibenden Ausgabeparameter lpbGroupDefaulted. Wenn der Sicherheitsdeskriptor eine primäre Gruppe enthält, legt die Funktion den Zeiger, auf den pGroup zeigt, auf die Adresse der Gruppen-SID des Sicherheitsdeskriptors fest und stellt einen gültigen Wert für die Variable bereit, auf die von lpbGroupDefaulted verwiesen wird.

[out] lpbGroupDefaulted

Ein Zeiger auf ein Flag, das auf den Wert des SE_GROUP_DEFAULTED-Flags in der SECURITY_DESCRIPTOR_CONTROL-Struktur festgelegt wird, wenn die Funktion zurückgibt. Wenn der Wert, der in der Variablen gespeichert ist, auf die der pGroup-Parameter verweist, NULL ist, wird kein Wert festgelegt.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlschlägt, wird null zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

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ßen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll