engOpenSingleUse (External Interfaces/API Reference)

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 an ActiveX 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 an ActiveX MATLAB engine server. engOpenSingleUse differs from engOpen, which allows multiple users to use the same ActiveX MATLAB engine server.

See Introducing MATLAB ActiveX Integration for additional details.

UNIX

This routine is not supported and simply returns.

engOpen engOutputBuffer