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

Siehe auch

Referenz

AtlGetSacl

CSacl-Klasse

Weitere Ressourcen

Sicherheits-globale Funktionen