HasMaskByTemplate Method
HasMaskByTemplate 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.
Determines if an entity object has the masks of a specified entity in a DACL template object.
Applies To
Syntax
[JScript] objResult objEntity.HasMaskByTemplate(strName, ObjDaclTemplate);
Parameters
- 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."- ObjDaclTemplate
A DACL object used as a template to compare with the entity object.
Return Value
An object that returns error codes and descriptions.
Remarks
Returns TRUE if one or more masks in the entity object are matched with DACL template object.
This method is useful for determining if a user, the entity object, has a particular right—the masks of a specified entity.
Example
var e = objDacl.SearchForObjectByNT4Name("MYDOMAIN\\User1");
// Returns the predefined DACL with the MAPI roles
var objMapiRoles = DaclLegacyRoles();
if(e.HasMaskByTemplate("Owner", objMapiRoles)) {
// User has that MAPI role }
See Also
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.