Forest.UpdateLocalSideOfTrustRelationship Method (String, String)

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

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

public void UpdateLocalSideOfTrustRelationship(
	string targetForestName,
	string newTrustPassword
)

Parameters

targetForestName
Type: System.String

The name of the Forest object for which the local trust password is to be changed.

newTrustPassword
Type: System.String

The new password for the trust relationship.

ExceptionCondition
ActiveDirectoryObjectNotFoundException

There is no trust relationship with the forest 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.

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