com.esri.arcgis.framework
Interface IMultiThreadedApplication

All Superinterfaces:

Serializable

All Known Implementing Classes:

Application, Application, Application, Application, IMultiThreadedApplicationProxy

public interface IMultiThreadedApplication
extends Serializable

Provides access to members that control DLL thread managers.

Remarks

Multithreading refers to a software configuration where independent paths of execution are in use simultaneously in an application. Each thread has its own stack and its own CPU state. The Application object implements the IMultiThreadedApplication interface that provides a simple callback mechanism for registering user created thread manager objects.

A thread manager object is any object that implements the IDllThreadManager interface. The thread manager object will be notified prior to application shutdown so that all currently running threads can be exited cleanly before the Application process actually shuts down. If you are developing components that will create threads and will be used in any of the ArcGIS application processes, the dll that contains these components must also contain an object that implements IDllThreadManager. Also, you must use the IMultiThreadedApplication interface to register this thread manager object with that application.

The IMultiThreadedApplication interface has methods for registering and unregistering thread managers with the application and returning the process ID of the application.

Product Availability

Available with ArcGIS Desktop.

See Also:

IDllThreadManager

Method Summary

int	getProcessID() The process ID for the application.
int	registerThreadManager(IDllThreadManager pThreadMgr) Registers a DLL thread manager with the application.
void	unregisterThreadManager(int mgrCookie) Unregisters a DLL thread manager with the application.

Method Detail

getProcessID

int getProcessID()
                 throws IOException,
                        AutomationException

The process ID for the application.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Returns:

The pid

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

registerThreadManager

int registerThreadManager(IDllThreadManager pThreadMgr)
                          throws IOException,
                                 AutomationException

Registers a DLL thread manager with the application.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Parameters:

pThreadMgr - A reference to a com.esri.arcgis.framework.IDllThreadManager (in)

Returns:

The mgrCookie

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

unregisterThreadManager

void unregisterThreadManager(int mgrCookie)
                             throws IOException,
                                    AutomationException

Unregisters a DLL thread manager with the application.

Product Availability

Available with ArcGIS Desktop.

Supported Platforms

Windows

Parameters:

mgrCookie - The mgrCookie (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.