AtlGetSacl

Wywołanie tej funkcji do pobierania informacji systemu kontroli dostępu (SACL) listy określonego obiektu.

Ważne
Nie można użyć tej funkcji w aplikacjach, które są wykonywane w Środowisko wykonawcze systemu Windows.

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

Parametry

• hObject
  Uchwyt do obiektu, z którego można pobrać informacji o zabezpieczeniach.

• ObjectType
  Określa wartość z SE_OBJECT_TYPE wyliczenia wskazująca typ obiektu, identyfikowane przez hObject parametru.

• pSacl
  Wskaźnik do obiektu SACL, który będzie zawierać informacje pobierane zabezpieczeń.

• bRequestNeededPrivileges
  Jeśli wartość true, funkcja będzie próbował włączyć przywileju SE_SECURITY_NAME i przywrócić ją po zakończeniu.

Wartość zwracana

Zwraca wartość true w przypadku powodzenia, false w przypadku niepowodzenia.

Uwagi

Jeśli AtlGetSacl jest wiele różnych obiektów można wywołać wiele razy będzie bardziej efektywne, aby włączyć przywileju SE_SECURITY_NAME raz przed wywołaniem funkcji, z bRequestNeededPrivileges wartość false.

Wymagania

Nagłówek: atlsecurity.h

Zobacz też

Informacje

AtlSetSacl

Klasa CSacl

Inne zasoby

Globalne funkcje zabezpieczeń