Export (0) Print
Expand All

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

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

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

public:
IAsyncResult^ BeginTerminate(
	Exception^ reason, 
	TimeSpan timeout, 
	AsyncCallback^ callback, 
	Object^ state
)

Parameters

reason
Type: System::Exception

The reason for terminating the workflow instance.

timeout
Type: System::TimeSpan

The interval in which the BeginTerminate operation must complete before the operation is canceled and a TimeoutException is thrown.

callback
Type: System::AsyncCallback

The method to be called when the BeginTerminate operation has completed.

state
Type: System::Object

An optional application-specific object that contains information about the asynchronous operation.

Return Value

Type: System::IAsyncResult
A reference to the current 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. EndTerminate can be called from inside or outside of the callback method. If EndTerminate 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. This or any other exceptions that occur during the BeginTerminate process is thrown from EndTerminate.

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

.NET Framework

Supported in: 4.5, 4

.NET Framework Client Profile

Supported in: 4

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.

Show:
© 2014 Microsoft