Location: Symbol Reference > Classes > TJwSecureFileObject Class > TJwSecureFileObject Methods > TJwSecureFileObject.TreeResetNamedSecurityInfo Method
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwSecureFileObject.TreeResetNamedSecurityInfo Method
Pascal
class procedure TreeResetNamedSecurityInfo(pObjectName: TJwString; const aSecurityInfo: TJwSecurityInformationFlagSet; const Owner: TJwSecurityId; const Group: TJwSecurityId; const DACL: TJwDAccessControlList; const SACL: TJwSAccessControlList; const bKeepExplicit: boolean; const fnProgress: TJwProgInvokeSetting; const FNProgressMethod: TJwFnProgressMethod; const FNProgressProcedure: TJwFnProgressProcedure; const ProgressUserData: Pointer); virtual; reintroduce;
Parameters 
Description 
const aSecurityInfo: TJwSecurityInformationFlagSet 
defines which security information to be set. (Owner...SACL). If a flag is not set, but the parameter Owner...SACL is not nil, it is also set. SECURITY_INFORMATION SecurityInfo,
SECURITY_INFORMATION SecurityInfo, 
const FNProgressMethod: TJwFnProgressMethod 
defines a object method to be called if a file or folder is changed. Can be nil. See TJwFnProgressMethod  
const FNProgressProcedure: TJwFnProgressProcedure 
defines a procedure to be called if a file or folder is changed. Can be nil. See TJwFnProgressProcedure  
const ProgressUserData: Pointer 
defines user data to be used as parameter ProgressUserData in the callback methods. 

TreeResetNamedSecurityInfo sets the securiy information of a folder and all its children. See MSDN for more information http://msdn2.microsoft.com/en-us/library/aa965849.aspx. This function needs Windows XP or higher. 

This method can restore the security information for a locked out user without using SeBackupPrivilege privilege. It uses a highly privileged system accout to do this. 

Both callback methods can be used at the same time. If both are not nil, they are called in the following order : FNProgressMethod, FNProgressProcedure. Exceptions are caught in these calls. 

 

Exceptions 
Description 
is raised if the winapi call failed. 
This is exception is raised if the Windows system does not support this call. 
Copyright (c) 2010. All rights reserved.
This help was created by Doc-O-Matic sponsored by toolsfactory software inc.
What do you think about this topic? Send feedback!