AtlSetSacl
Rufen Sie diese Funktion, um die Informationen der Systemzugriffssteuerungsliste (SACL) eines angegebenen Objekts festzulegen.
Wichtig
Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.
inline bool AtlSetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CSacl& rSacl,
DWORD dwInheritanceFlowControl= 0,
bool bRequestNeededPrivileges= true
) throw(...);
Parameter
hObject
Handle für das Objekt, damit das Sicherheitsinformationen festgelegt wird.ObjectType
Gibt einen Wert aus der Enumeration SE_OBJECT_TYPE an, die den Typ des Objekts identifiziert durch den hObject-Parameter angibt.rSacl
Das SACLs, die den neuen Sicherheitsinformationen enthält.dwInheritanceFlowControl
Die Vererbungsflusssteuerung. Dieser Wert kann 0 (Standard), PROTECTED_SACL_SECURITY_INFORMATION oder UNPROTECTED_SACL_SECURITY_INFORMATION sein.bRequestNeededPrivileges
Wenn true, die Funktion versucht, das SE_SECURITY_NAME-Recht aktivieren und es auf Abschluss wiederherstellt.
Rückgabewert
Gibt bei Erfolg true zurück, bei einem Fehler false.
Hinweise
In Debugbuilds ein Assertionsfehler tritt auf, wenn hObject ungültig ist oder wenn dwInheritanceFlowControl keiner der drei zulässigen Werte ist.
Wenn AtlSetSacl aufgerufen werden soll oft auf vielen verschiedenen Objekten, ist es effizienter, das SE_SECURITY_NAME-Recht einmal zu aktivieren, bevor die Funktion aufgerufen wird, wenn bRequestNeededPrivileges auf false festgelegt ist.
Anforderungen
Header: atlsecurity.h