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)

'Declaration
Public Sub UpdateLocalSideOfTrustRelationship ( _
	targetForestName As String, _
	newTrustDirection As TrustDirection, _
	newTrustPassword As String _
)

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 Nothing.

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft