This documentation is archived and is not being maintained.

WorkflowApplication::BeginTerminate Method (String, TimeSpan, AsyncCallback, Object)

Terminates a workflow instance asynchronously using the specified error message, time-out interval, callback method, and user-provided state.

Namespace:  System.Activities
Assembly:  System.Activities (in System.Activities.dll)

IAsyncResult^ BeginTerminate(
	String^ reason, 
	TimeSpan timeout, 
	AsyncCallback^ callback, 
	Object^ state


Type: System::String
The reason for terminating the workflow instance.
Type: System::TimeSpan
The interval in which the BeginTerminate() operation must complete before the operation is canceled and a TimeoutException is thrown.
Type: System::AsyncCallback
The method to be called when the BeginTerminate() operation has completed.
Type: System::Object
An optional application-specific object that contains information about the asynchronous operation.

Return Value

Type: System::IAsyncResult
A reference to the asynchronous BeginTerminate() operation.

This method schedules the termination of the workflow instance. To be notified when the termination has completed, use the OnCompleted() handle.

To determine whether the BeginTerminate() operation was successful, call EndTerminate(IAsyncResult). EndTerminate(IAsyncResult) can be called from inside or outside of the method reference in the callback parameter. If EndTerminate(IAsyncResult) is called before the BeginTerminate() operation completes, it blocks until the BeginTerminate() operation completes. If the BeginTerminate() operation does not complete within the specified time-out interval a TimeoutException is thrown from EndTerminate(IAsyncResult).

This method terminates a workflow instance asynchronously using the IAsyncResult asynchronous design pattern. For more information, seeAsynchronous Programming Overview.

.NET Framework

Supported in: 4

.NET Framework Client Profile

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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