Share via

  • Article

RemoveByDisplayName Method

Topic Last Modified: 2006-06-13

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

Applies To

DACL Object

Syntax


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

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