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.6, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft