Main Content

actxGetRunningServer

Handle to running instance of Automation server

collapse all in page

Syntax

c = actxGetRunningServer(progid)

Description

c = actxGetRunningServer(progid) gets a reference to a running instance of the OLE Automation server. Returns a handle to the default interface of the server.

If the server specified by progid is not currently running or if the server object is not registered, then the function returns an error. If multiple instances of the server are running, then the operating system controls the behavior of this function.

example

Examples

collapse all

c = actxGetRunningServer('Excel.Application');
list = fieldnames(c)

Input Arguments

collapse all

Programmatic identifier, specified as a string or a character vector. The server vendor documentation specifies the ProgID.

Example: 'Excel.Application'

Output Arguments

collapse all

COM object, returned as a function handle.

Limitations

  • COM functions are available on Microsoft® Windows® systems only.

Version History

Introduced in R2007a

See Also