AtlSetSacl
Chiamare la funzione per impostare le informazioni di (SACL) dell'elenco di controllo di accesso di sistema di un oggetto specificato.
.gif "Nota importante") Importante |
|---|
Questa funzione non può essere utilizzata nelle applicazioni eseguite in Windows Runtime. |
inline bool AtlSetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CSacl& rSacl,
DWORD dwInheritanceFlowControl= 0,
bool bRequestNeededPrivileges= true
) throw(...);
Parametri
hObject
Un handle per l'oggetto per il quale a informazioni sulla sicurezza stabilite.ObjectType
Specifica un valore dall'enumerazione SE_OBJECT_TYPE che indica il tipo di oggetto identificato dal parametro hObject.rSacl
Il SACL che contiene le nuove informazioni sulla sicurezza.dwInheritanceFlowControl
Il controllo del flusso di ereditarietà.Questo valore può essere 0 (impostazione predefinita), PROTECTED_SACL_SECURITY_INFORMATION o UNPROTECTED_SACL_SECURITY_INFORMATION.bRequestNeededPrivileges
Se true, la funzione tenta di abilitare il privilegio di SE_SECURITY_NAME e viene reimpostata sul completamento.
Valore restituito
Restituisce true se l'operazione ha esito positivo, false in caso di esito negativo.
Note
Nelle build di debug, un errore di asserzione si verificherà se hObject non è valido, o se dwInheritanceFlowControl non è uno dei tre valori consentiti.
Se AtlSetSacl deve essere chiamato più volte su molti oggetti diversi, sarà più efficiente abilitare una volta il privilegio di SE_SECURITY_NAME prima di chiamare la funzione, con bRequestNeededPrivileges impostato su false.
Requisiti
Header: atlsecurity.h