This documentation is archived and is not being maintained.

Forest.UpdateLocalSideOfTrustRelationship Method (String, TrustDirection, String)

Updates the password and trust direction for the local side of a trust relationship.

Namespace:  System.DirectoryServices.ActiveDirectory
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

public void UpdateLocalSideOfTrustRelationship(
	string targetForestName,
	TrustDirection newTrustDirection,
	string newTrustPassword
)

Parameters

targetForestName
Type: System.String
The name of the Forest object for which the local trust direction and password must be changed.
newTrustDirection
Type: System.DirectoryServices.ActiveDirectory.TrustDirection
A TrustDirection value for the new trust direction for the trust relationship.
newTrustPassword
Type: System.String
The new password for the trust relationship.

ExceptionCondition
ActiveDirectoryObjectNotFoundException

There is no trust relationship with the Forest object that is specified by targetForestName.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentException

targetForestName or newTrustPassword is an empty string.

ArgumentNullException

targetForestName or newTrustPassword is null.

InvalidEnumArgumentException

The newTrustDirection parameter is not a valid TrustDirection value.

ObjectDisposedException

The object has been disposed.

UnauthorizedAccessException

The specified account does not have permission to perform this operation.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: