Export (0) Print
Expand All

SearchForObjectForAnEqualMask Method

Exchange Server 2003

SearchForObjectForAnEqualMask 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 whose masks are equal to the specified masks.

Applies To

Syntax

        [JScript]
objEntity  objDACL.SearchForObjectForAnEqualMask(Masks);

Parameters

Masks
An array of one or more hexadecimal values. Each mask is the 32-bit access mask for the Access Control Entry (ACE).

Return Value

A returned entity object.

Remarks

This method differs from SearchForObjectByMask in that only a set of masks that are equal in number to the specified masks will result in a match. This method calls the entity object's IsEqualMask Method for searching.

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

Example

var objEntity = objDacl.SearchForObjectForAnEqualMask([0x1, 0x2, 0x3, 0x4, 0x5, 0x6]);
if(null == objEntity){
    //no one had this mask
}

See Also

SearchForObjectByDisplayName Method

SearchForObjectByMask Method

SearchForObjectByNT4Name Method

SearchForObjectBySID Method

SearchForObjectBySIDType Method

Show:
© 2014 Microsoft