SearchForIndexByDisplayName Method

SearchForIndexByDisplayName 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 the index of an entity in a DACL object by a specified display name.

Applies To

DACL Object

Syntax

[JScript] ndxEntity  objDACL.SearchForIndexByDisplayName(strDisplayName);

Parameters

  • strDisplayName
    A string value of the display name for the specified security principal such as "Jane Clayton."

Return Value

A long value of the entity's index. This method returns a negative number if the entity is not found.

Remarks

This method is not the most effective search method because only the first matched entity would be found if more than one entity had the same display name.

Indexes are zero-based.

Example

var index = objDacl.SearchForIndexByDisplayName("Jane Clayton");

if(index<0){ //user not found }

See Also

SearchForIndexByMask Method

SearchForIndexBySID Method

SearchForIndexBySIDType Method

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