SetSecurityDescriptorControl-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die SetSecurityDescriptorControl-Funktion legt die Steuerelementbits eines Sicherheitsdeskriptors fest. Die Funktion kann nur die Steuerelementbits festlegen, die sich auf die automatische Vererbung von ACEs beziehen. Um die anderen Steuerelementbits eines Sicherheitsdeskriptors festzulegen, verwenden Sie die Funktionen, z. B . SetSecurityDescriptorDacl, um die Komponenten eines Sicherheitsdeskriptors zu ändern.

Syntax

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

Parameter

[in] pSecurityDescriptor

Ein Zeiger auf eine SECURITY_DESCRIPTOR Struktur, deren Steuerungs- und Revisionsinformationen festgelegt sind.

[in] ControlBitsOfInterest

Eine SECURITY_DESCRIPTOR_CONTROL Maske, die die festzulegenden Steuerelementbits angibt.

[in] ControlBitsToSet

Eine SECURITY_DESCRIPTOR_CONTROL Maske, die die neuen Werte für die Steuerelementbits angibt, die von der ControlBitsOfInterest-Maske angegeben werden.

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.

Hinweise

Die SetSecurityDescriptorControl-Funktion gibt das zu ändernde Steuerelementbit bzw. die zu ändernden Bits an und gibt an, ob die Bits aktiviert oder deaktiviert sind.

Beispiele

Im folgenden Beispiel wird die DACL im Sicherheitsdeskriptor als geschützt markiert.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

Im folgenden Beispiel wird die DACL als nicht geschützt markiert.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

Anforderungen


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