Freigeben über


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 Class

Weitere Ressourcen

Security Global Functions