SetByTemplate Method (DACL Object)
Topic Last Modified: 2006-06-13
Provides the ability to bit-wise OR the masks of the DACL object, according to a specified DACL template name and entity name.
Applies To
Syntax
objResult objDACL.SetByTemplate(strNT4Name, objDACLTemplate, strNT4NameInDACLTemplate);
Parameters
- strNT4Name
A string value of the domain and username of a security principal.
- objDACLTemplate
A DACL object used as a template.
- strNT4NameInDACLTemplate
A string value of the name of an entity in the DACL template object used to compare with the DACL object being evaluated.
Return Value
An object that returns error codes and descriptions.
Remarks
This method is the same as the ModifyByTemplate method, except that the only action taken is to bit-wise OR the masks.
The following possible error messages can be returned:
- Person not found.
- Template entity not found.
Example
var objLRoles = DaclLegacyRoles();
var objErr = objDacl.SetByTemplate("MYDOMAIN\\User1", objLRoles, "Reviewer");
if(FAILED(objErr.number)){
//something went wrong
}
See Also
Other Resources
ClearByTemplate Method
MakeEqualToTemplate Method
ModifyByTemplate Method
DACL Templates