External Interfaces/API Reference

engOpenSingleUse

Start a MATLAB engine session for single, nonshared use

C Syntax

• #include "engine.h"
  Engine *engOpenSingleUse(const char *startcmd, void *dcom, 
  int *retstatus);
  

Arguments

startcmd
   String to start MATLAB process. On Windows, the startcmd string must be NULL.

dcom
   Reserved for future use; must be NULL.

retstatus
   Return status; possible cause of failure.

Description

Windows

This routine allows you to start multiple MATLAB processes for the purpose of using MATLAB as a computational engine. engOpenSingleUse starts a MATLAB process, establishes a connection, and returns a unique engine identifier, or NULL if the open fails. engOpenSingleUse starts a new MATLAB process each time it is called.

engOpenSingleUse opens a COM channel to MATLAB. This starts the MATLAB that was registered during installation. If you did not register during installation, on the command line you can enter the command:

• matlab /regserver
  

engOpenSingleUse allows single-use instances of a MATLAB engine server. engOpenSingleUse differs from engOpen, which allows multiple users to use the same MATLAB engine server.

See Introducing MATLAB COM Integration for additional details.

UNIX

This routine is not supported and simply returns.

engOpen

engOutputBuffer