SetSecurityDescriptorGroup-Funktion (securitybaseapi.h)

Artikel
03/04/2024

Die SetSecurityDescriptorGroup-Funktion legt die primären Gruppeninformationen eines absoluten Sicherheitsdeskriptors fest und ersetzt alle Informationen der primären Gruppe, die bereits im Sicherheitsdeskriptor vorhanden sind.

Syntax

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Parameter

[in, out] pSecurityDescriptor

Ein Zeiger auf die SECURITY_DESCRIPTOR Struktur, deren primäre Gruppe von dieser Funktion festgelegt wird. Die Funktion ersetzt jede vorhandene primäre Gruppe durch die neue primäre Gruppe.

[in, optional] pGroup

Ein Zeiger auf eine SID-Struktur für die neue primäre Gruppe des Sicherheitsdeskriptors. Auf die SID-Struktur wird vom Sicherheitsdeskriptor verwiesen, nicht in diese kopiert. Wenn dieser Parameter NULL ist, löscht die Funktion die Primären Gruppeninformationen des Sicherheitsdeskriptors. Dadurch wird der Sicherheitsdeskriptor als keine primäre Gruppe markiert.

[in] bGroupDefaulted

Gibt an, ob die Primären Gruppeninformationen von einem Standardmechanismus abgeleitet wurden. Wenn dieser Wert TRUE ist, handelt es sich um Standardinformationen, und die Funktion speichert diesen Wert als SE_GROUP_DEFAULTED Flag in der SECURITY_DESCRIPTOR_CONTROL-Struktur . Wenn dieser Parameter 0 ist, wird das flag SE_GROUP_DEFAULTED gelöscht.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. 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ßlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll