AtlGetSacl

Rufen Sie diese Funktion, um die Informationen der Systemzugriffssteuerungsliste (SACL) eines angegebenen Objekts abzurufen.

Wichtig
Diese Funktion kann nicht in den Anwendungen verwendet werden, die in Windows-Runtime ausführen.

inline bool AtlGetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
CSacl* pSacl,
bool bRequestNeededPrivileges= true
) throw(...);

Parameter

• hObject
  Handle aus dem auf das Objekt, um die Sicherheitsinformationen abzurufen.

• ObjectType
  Gibt einen Wert aus der Enumeration SE_OBJECT_TYPE an, die den Typ des Objekts identifiziert durch den hObject-Parameter angibt.

• pSacl
  Zeiger auf einen SACL-Objekt, das die abgerufenen Sicherheitsinformationen enthält.

• 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

Wenn AtlGetSacl 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

AtlSetSacl

CSacl-Klasse

Weitere Ressourcen

Sicherheits-globale Funktionen