actxGetRunningSrv

Handle to running instance of Automation server.

Syntax

  • h = actxGetRunningSrv(progid)

Input argument

  • progid - a string: the name of a COM server.

Output argument

  • h - a COM object.

Description

h = actxGetRunningSrv(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

Author

Allan CORNET

PreviousSUMMARYNextactxcontrollist

Last updated