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