SearchForObjectByMask Method

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

Returns an entity object found by searching for a specified masks.

Applies To

DACL Object

Syntax

[JScript] objEntity  objDACL.SearchForObjectByMask(masks);

Parameters

  • masks
    An array of six hexadecimal values that represent the entity's permissions.

Return Value

An entity object.

Remarks

If there is more than one entity in the DACL with the same set of masks, this method only returns one object of the first matched set.

This method uses the HasMask Method for searching.

Example

var objEntity = objDacl.SearchForObjectByMask([0x1, 0x2, 0x3, 0x4, 0x5, 0x6]);

if(null == objEntity){ //no one had this mask }

See Also

SearchForObjectByDisplayName Method

SearchForObjectByNT4Name Method

SearchForObjectBySID Method

SearchForObjectBySIDType Method

SearchForObjectForAnEqualMask Method

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.