<< COM_xlswrite COM engine actxcontrollist >>

actxGetRunningServer


Handle to running instance of Automation server.


Syntax


h = actxGetRunningServer(progid)

Input argument


progid

a string: the name of a COM server.

Output argument


h

a COM object.

Description


h = actxGetRunningServer(progid) gets a reference to a running instance of the OLE/COM Automation server.

progid is the programmatic identifier of the Automation server object and h is the handle to the default interface of the server object.

The function returns an error if the server specified by progid is not currently running or if the server object is not registered.

When multiple instances of the Automation server are running, the operating system controls the behavior of this function.

Example


h = actxGetRunningServer('Excel.application')

See also


actxserver.

History


Version Description
1.0.0 initial version

Author


Allan CORNET

<< COM_xlswrite COM engine actxcontrollist >>