This documentation is archived and is not being maintained.

Forest.VerifyTrustRelationship Method

Verifies that a previously established trust with the specified forest is valid.

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

public void VerifyTrustRelationship (
	Forest targetForest,
	TrustDirection direction
)
public void VerifyTrustRelationship (
	Forest targetForest, 
	TrustDirection direction
)
public function VerifyTrustRelationship (
	targetForest : Forest, 
	direction : TrustDirection
)
Not applicable.

Parameters

targetForest

A Forest object for which to verify the trust relationship.

direction

A TrustDirection value that specifies the direction of the trust, relative to this forest.

Return Value

If the trust is verified, the method returns without throwing an exception. If the trust cannot be verified, the method will throw an ActiveDirectoryObjectNotFoundException exception.

Exception typeCondition

ActiveDirectoryObjectNotFoundException

There is no trust relationship with the forest that is specified by targetForest, or the target forest does not have the trust direction that is specified by direction.

ActiveDirectoryOperationException

A call to the underlying directory service resulted in an error.

ActiveDirectoryServerDownException

The target server is either busy or unavailable.

ArgumentNullException

targetForest is a null reference (Nothing in Visual Basic).

InvalidEnumArgumentException

The direction 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.

This method verifies that a trust relationship has been fully established. The trust is not established until both sides of the trust have been created.

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0
Show: