RemoveByDisplayName Method

Removes an entity object from a DACL object by using a display name to find the entity.

Applies To

DACL Object

Syntax

Copy

[JScript]
objResult  objDACL.RemoveByDisplayName(strDisplayName);

Parameters

strDisplayName

A string value of the display name for a security principal such "Jane Clayton."

Return Value

An object that returns error codes and descriptions.

Remarks

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

Example

Copy

var objErr = objDacl.RemoveByDisplayName("Jane Clayton");
if(FAILED(objErr.number)){
    //there was an error removing that user, print objErr.description
}

See Also

RemoveByIndex Method

RemovebyNT4Name Method

RemovebySID Method