Share via

  • Article

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

DACL Object

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
}