## Description

Include file: xrexx.h

### Functions

#### XRexxInterface

#### Parameters

char * name | the symbolic name of the interface
char * dllName | the name of the DLL
char * proc | the name of your function

char * name the symbolic name of the interface
PFN proc the adress of your function

#### Remarks

Creates an interface to REXX. Therefore a C-function of you application (DLL) will be registered. The function must have following format:

REXXINTERFACE Handler(PRXSTRING commandString, PUSHORT flags, PRXSTRING returnString)

Commands which are not known in a rexx-script running in this interface will be posted to the handler.
Creates an interface to REXX. Therefore a C-function of your application (EXE) will be registered. The function must have following format:

REXXINTERFACE Handler(PRXSTRING commandString, PUSHORT flags, PRXSTRING returnString)

Commands which are not known in a rexx-script running in this interface will be posted to the handler.

#### Exceptions

If the method fails an exception of the type XRexxException is thrown.
If the method fails an exception of the type XRexxException is thrown.

#### Execute

#### Parameters

char * commandFile | name of a file which contains the script
LONG type | type of command (see rexx program reference)
XString * result | buffer for result
SHORT returnCode | buffer for returncode
XString * args | string which contains the arguments for the script

#### Return-Value

LONG result return-code from the operating system

#### Remarks

Run a REXX-script

#### GetHandler

#### Parameters

char * handlerName the name of the rexx interface used in the constructor
char * dllName name of the DLL if used (default is NULL)

#### Return-Value

XRexxInterface * pointer pointer to an interface (NULL if no interface found)

#### Remarks

Returns a pointer to a XRexxInterface

#### DeregisterFunction

#### Parameters

char * name symbolic name of the function

#### Return-Value

LONG result return-code from the operating system

#### Remarks

Deregister a function

#### IsFunctionRegistered

#### Parameters

char * name symbolic name of the function

#### Return-Value

BOOL result

#### Remarks

Query if a function is registered

#### RegisterFunction

#### Parameters

char * name | symbolic name of the function which must be used in the rexx-script
char * dllName | name of the dll
char * proc | real name of the function

char * name symbolic name of the function which must be used in the rexx-script
PFN proc adress of the function

#### Return-Value

LONG result return-code from the operating system
LONG result return-code from the operating system

#### Remarks

Register a C-function of your application (DLL) so that it can be called from a rexx-script. The function must have the following format:

REXXINTERFACE MyFunc( PUCHAR name, ULONG argc, PRXSTRING argv, PSZ queue, PRXSTRING ret)
Register a C-function of your application (EXE) so that it can be called from a rexx-script. The function must have the following format:

REXXINTERFACE MyFunc( PUCHAR name, ULONG argc, PRXSTRING argv, PSZ queue, PRXSTRING ret)

#### GetVar

#### Parameters

char * name name of the variable
XString * value buffer for the value of the variable

#### Return-Value

LONG result return-code from the operating system

#### Remarks

Query a variable for a running rexx-script

#### SetVar

#### Parameters

char * name name of the variable
char * value value of the variable

#### Return-Value

LONG result return-code from the operating system

#### Remarks

Set a variable for a running rexx-script

This document was generated by Jens von Pilgrim's Autodoc