AtlSetSacl
Volání funkce informace o systému řízení přístupu k seznamu (SACL) zadaného objektu.
Dů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