Sdílet prostřednictvím


AtlSetSacl

Volání funkce informace o systému řízení přístupu k seznamu (SACL) zadaného objektu.

Důležitá poznámkaDůležité

Tuto funkci nelze použít v aplikacích, které v .

inline bool AtlSetSacl( 
HANDLE hObject, 
SE_OBJECT_TYPE ObjectType, 
const CSacl& rSacl, 
DWORD dwInheritanceFlowControl= 0, 
bool bRequestNeededPrivileges= true 
) throw(...);

Parametry

  • hObject
    Popisovač objektu, pro který chcete nastavit informace o zabezpečení.

  • ObjectType
    Určuje hodnotu z SE_OBJECT_TYPE výčet označující typ objektu, které jsou identifikovány hObject parametr.

  • rSacl
    Seznam SACL obsahující nové informace o zabezpečení.

  • dwInheritanceFlowControl
    Řízení toku dědičnosti.Tato hodnota může být 0 (výchozí), PROTECTED_SACL_SECURITY_INFORMATION nebo UNPROTECTED_SACL_SECURITY_INFORMATION.

  • bRequestNeededPrivileges
    Pokud je hodnota true, funkce se pokusí povolit oprávnění SE_SECURITY_NAME a obnovení po dokončení.

Vrácená hodnota

Vrátí hodnotu true při úspěchu, false při selhání.

Poznámky

V sestavení ladění, dojde k chybě výrazu Pokud hObject je neplatný, nebo pokud dwInheritanceFlowControl není jedním ze tří povolených hodnot.

Pokud AtlSetSacl je volat mnohokrát v mnoha různých objektů, bude efektivnější zapnout oprávnění SE_SECURITY_NAME jednou před voláním funkce, s bRequestNeededPrivileges nastavena na hodnotu false.

Požadavky

Záhlaví: atlsecurity.h

Viz také

Referenční dokumentace

AtlGetSacl

Třída CSacl

Další zdroje

Globální funkce zabezpečení