3.3.2.13 DLL


Syntax:

dll [option] dllName <dllFunctionName dllString>

Options:

no option; Execute a function called dllFunctionName from a user-provided Dynamic Link Library named dllName

Syntax: dll dllName dllFunctionName diiString

Execute a function called dllFunctionName from a user-provided Dynamic Link Library named dllName. The dllString is passed to the DLL, which uses the string to perform necessary tasks.

-a; Add the dllName DLL to the LabTalk command list as a new command object named objectName

Syntax: dll -a objectName dllName

Add the dllName DLL to the LabTalk command list as a new command object named objectName.Do not reference a variable or DLL already in use by Origin. This DLL must have been created using information provided by OriginLab and conform to Origin's external DLL convention. The DLL can also be added to Origin through the [AddOn] section in the ORIGIN.INI file.

-a; Add the dllName DLL to the LabTalk command list that named objectName and read it from the DLL's resource

Syntax: dll -a dllName

Add the dllName DLL to the LabTalk command list as a new command object named objectName; reads objectName from the DLL's resource.Same as -a objectName dllName, except that Origin reads the objectName from the DLL's resource. The name must be in the string table with an ID value of 1.

-l; List all current objects and the DLL

Syntax: dll -l

List all current objects and the DLL that each is mapped to in the Script window.

-r; Remove an added object (unload the DLL)

Syntax: dll -r objectName

Remove an added object (unload the DLL).A command error will occur if objectName is not mapped to a DLL. This command error causes later script to not get executed. To get around this problem, enclose the dll -r command in {dll -r obj}.

-rc; Unload the dllName DLL that was loaded and used by Origin C

Syntax: dll -rc dllName

Unload the dllName DLL that was loaded and used by Origin C. Origin C loaded the DLL when compiling a source file that contained the "#pragma dll(dllName)" statement. This option is useful when developing and testing a DLL for use with Origin C. You can use this option to unload the DLL without restarting Origin.

Examples:

dll -a myobj myobj.dll; // Map a MOCA DLL to a LabTalk object.
myobj.method();         // Call a method.
dll -r myobj;           // Remove mapping and unload DLL.
dll -rc myocdll;  // Unload a DLL that was loaded and used by Origin C.