• Article

MakeEqualToTemplate Method (Entity Object)

Topic Last Modified: 2006-06-13

Sets the masks in an entity object equal to the masks of a specified entity in a DACL template object.

Applies To

Entity Object

Syntax


objResult  objEntity.MakeEqualToTemplate(ObjDaclTemplate, strName);

Parameters

  • ObjDaclTemplate
    A DACL object used as a template to compare with the entity object.
  • strName
    A string value of an entity to match in the DACL template. This value can either be the domain and username of a user or group, or a predefined role such as an "Author."

Return Value

An object that returns error codes and descriptions.

Example

var e = objDacl.SearchForObjectByNT4Name("MyDomain\User1");

// Returns the predefined DACL with the MAPI roles
var objMapiRoles = DaclLegacyRoles();   
objResult = e.MakeEqualToTemplate("Owner", objMapiRoles);
if(FAILED(objResult.number)){
    
// Print the error message stored in objResult.description
}