ClearByTemplate Method (Entity Object)
Topic Last Modified: 2006-06-13
Clears from an entity object the masks of a specified entity in a DACL template.
Applies To
Syntax
objResult objEntity.ClearByTemplate(objDACLTemplate, strName);
Parameters
- objDACLTemplate
A DACL object used as a template.
- 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");
var objMapiRoles = DaclLegacyRoles(); //returns the predefined dacl with the mapi roles
objResult = e.ClearByTemplate(objMapiRoles, "owner");
if(FAILED(objResult.number)){
//print the error message stored in objResult.description
}