IDL_RPCExecuteStr

Calling Sequence

int IDL_RPCExecuteStr(CLIENT *pClient, char * pCommand) 

Description

Use this function to send IDL commands to the IDL RPC server. The command is executed just as if it had been entered from the IDL command line.

This function cannot be used to send multiple line commands and will return an error if a "$" is detected at the end of the command string. It will also return an error if "$" is the first character, since this would spawn an interactive process and hang the IDL RPC server.

Parameters

pClient

A pointer to the CLIENT structure that corresponds to the desired IDL session.

pCommand

A null-terminated IDL command string.

Return Value

This function returns the following values:

1 — Success.

0 — Invalid command string.

For all other errors, the value of !ERROR_STATE.CODE is returned. This number could be passed as an argument to the IDL function STRMESSAGE() to determine the exact cause of the error.