Location: Symbol Reference > Classes > TJwSecureGeneralObject Class > TJwSecureGeneralObject Methods > SetNamedSecurityInfo Method > TJwSecureGeneralObject.SetNamedSecurityInfo Method (TJwString, TSeObjectType, TJwSecurityInformationFlagSet, TJwSecurityId, TJwSecurityId, TJwDAccessControlList, TJwSAccessControlList)
JWSCL Documentation
ContentsIndexHome
PreviousUpNext
TJwSecureGeneralObject.SetNamedSecurityInfo Method (TJwString, TSeObjectType, TJwSecurityInformationFlagSet, TJwSecurityId, TJwSecurityId, TJwDAccessControlList, TJwSAccessControlList)
Pascal
class procedure SetNamedSecurityInfo(const anObjectName: TJwString; const aObjectType: TSeObjectType; aSecurityInfo: TJwSecurityInformationFlagSet; const anOwner: TJwSecurityId; const anGroup: TJwSecurityId; const aDACL: TJwDAccessControlList; const aSACL: TJwSAccessControlList); override; overload;
Parameters 
Description 
const anObjectName: TJwString 
defines the name of a handle which security information is to be changed  
const aObjectType: TSeObjectType 
defines the handle type  
aSecurityInfo: TJwSecurityInformationFlagSet 
defines which security information is retrieved from the SD and used in the handle For files and folders the object inheritance flow can be stopped by using the flag siProtectedDaclSecurityInformation. In this case all inherited ACEs are removed from the DACL leaving the explicit ACEs only. The flag siUnprotectedDaclSecurityInformation allows the inheritance flow to the file object. Thus this flags reverts the flag siProtectedDaclSecurityInformation.
Both flags must be used with the combination of siDaclSecurityInformation and a DACL that is not nil. An empty DACL is necessary to change this flag. The same function is done by RemoveInheritanceFlow and RestoreInheritanceFlow.
 
const anOwner: TJwSecurityId 
if aSecurityInfo contains the flag siOwnerSecurityInformation, this parameter will receive the OwnerSID to be changed in the destination. If this parameter is not nil, the flag is automatically added and the parameter is used.  
const anGroup: TJwSecurityId 
if aSecurityInfo contains the flag siGroupSecurityInformation, this parameter will receive the GroupSID to be changed in the destination. If this parameter is not nil, the flag is automatically added and the parameter is used.  
const aDACL: TJwDAccessControlList 
if aSecurityInfo contains the flag siDaclSecurityInformation, this parameter will receive the DACL to be changed in the destination. If this parameter is not nil, the flag is automatically added and the parameter is used.  
const aSACL: TJwSAccessControlList 
if aSecurityInfo contains the flag siSaclSecurityInformation, this parameter will receive the DACL to be changed in the destination. If this parameter is not nil, the flag is automatically added and the parameter is used. 

SetNamedSecurityInfo sets security information of a handle.

Exceptions 
Description 
will be raised if a call to the winapi function failed. 
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!