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.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft