SecurityIdentifier.Translate Method (Type)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Translates the account name represented by the SecurityIdentifier object into another IdentityReference-derived type.

Namespace:   System.Security.Principal
Assembly:  mscorlib (in mscorlib.dll)

[SecurityPermissionAttribute(SecurityAction.Demand, ControlPrincipal = true)]
public override IdentityReference Translate(
	Type targetType
)

Parameters

targetType
Type: System.Type

The target type for the conversion from SecurityIdentifier. The target type must be a type that is considered valid by the IsValidTargetType method.

Return Value

Type: System.Security.Principal.IdentityReference

The converted identity.

Exception Condition
ArgumentNullException

targetType is null.

ArgumentException

targetType is not an IdentityReference type.

IdentityNotMappedException

Some or all identity references could not be translated.

SystemException

A Win32 error code was returned.

SecurityPermission

for the ability to manipulate the principal object. Associated enumeration: SecurityPermissionFlag.ControlPrincipal

.NET Framework
Available since 2.0
Return to top
Show: