SetByTemplate Method

SetByTemplate 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.

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

[JScript] objResult  objDACL.SetByTemplate(strNT4NameobjDACLTemplatestrNT4NameInDACLTemplate);

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 }

See Also

ClearByTemplate Method

MakeEqualToTemplate Method

ModifyByTemplate 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.