Share via

ClearByTemplate Method

  • Article

ClearByTemplate Method

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Clears from an entity object the masks of a specified entity in a DACL template.

Applies To

Entity Object

Syntax



[JScript]
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
}



See Also




MakeEqualToTemplate Method


SetByTemplate Method


DACL Templates




Send us your feedback about the Microsoft Exchange Server 2003 SDK.


Build: June 2007 (2007.618.1)


© 2003-2006 Microsoft Corporation. All rights reserved. Terms of use.