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