AtlSetSacl

Wywołanie tej funkcji, aby ustawić 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 AtlSetSacl( 
HANDLE hObject, 
SE_OBJECT_TYPE ObjectType, 
const CSacl& rSacl, 
DWORD dwInheritanceFlowControl= 0, 
bool bRequestNeededPrivileges= true 
) throw(...);

Parametry

• hObject
  Uchwyt do obiektu, dla którego ustawiono informacje zabezpieczeń.

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

• rSacl
  SACL, zawierający nowe informacje zabezpieczeń.

• dwInheritanceFlowControl
  Sterowanie przepływem dziedziczenia.Ta wartość może być 0 (domyślnie), PROTECTED_SACL_SECURITY_INFORMATION lub UNPROTECTED_SACL_SECURITY_INFORMATION.

• 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

W kompilacjach debugowania potwierdzenia wystąpi błąd Jeśli hObject jest nieprawidłowy, lub jeśli dwInheritanceFlowControl nie jest jedną z trzech wartości dopuszczalnej.

Jeśli AtlSetSacl 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

AtlGetSacl

Klasa CSacl

Inne zasoby

Globalne funkcje zabezpieczeń