Forest.UpdateLocalSideOfTrustRelationship Method

Definition

Namespace:

System.DirectoryServices.ActiveDirectory

Assembly:

System.DirectoryServices.dll

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

Overloads

UpdateLocalSideOfTrustRelationship(String, String)	Updates the password for the local side of a trust relationship.
UpdateLocalSideOfTrustRelationship(String, TrustDirection, String)	Updates the password and trust direction for the local side of a trust relationship.

UpdateLocalSideOfTrustRelationship(String, String)

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

public:
 void UpdateLocalSideOfTrustRelationship(System::String ^ targetForestName, System::String ^ newTrustPassword);

public void UpdateLocalSideOfTrustRelationship (string targetForestName, string newTrustPassword);

member this.UpdateLocalSideOfTrustRelationship : string * string -> unit

Public Sub UpdateLocalSideOfTrustRelationship (targetForestName As String, newTrustPassword As String)

Parameters

targetForestName

String

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

newTrustPassword

String

The new password for the trust relationship.

Exceptions

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.

See also

• Working With Trusts

UpdateLocalSideOfTrustRelationship(String, TrustDirection, String)

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

public:
 void UpdateLocalSideOfTrustRelationship(System::String ^ targetForestName, System::DirectoryServices::ActiveDirectory::TrustDirection newTrustDirection, System::String ^ newTrustPassword);

public void UpdateLocalSideOfTrustRelationship (string targetForestName, System.DirectoryServices.ActiveDirectory.TrustDirection newTrustDirection, string newTrustPassword);

member this.UpdateLocalSideOfTrustRelationship : string * System.DirectoryServices.ActiveDirectory.TrustDirection * string -> unit

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

Parameters

targetForestName

String

The name of the Forest object for which the local trust direction and password must be changed.

newTrustDirection

TrustDirection

A TrustDirection value for the new trust direction for the trust relationship.

newTrustPassword

String

The new password for the trust relationship.

Exceptions

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.

See also

• TrustDirection