IDL_RPCGetMainVariable

Calling Sequence

IDL_VPTR IDL_RPCGetMainVariable(CLIENT *pClient, char *Name) 

Description

Call this function to get the value of an IDL RPC server main level variable referenced by the name contained in Name. IDL_RPCGetMainVariable will then return a pointer to an IDL_VARIABLE structure that contains the value of the variable.

Parameters

pClient

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

Name

The name of the variable to find.

Return Value

On success, this function returns a pointer to an IDL_VARIABLE structure that contains the value of the desired IDL RPC main level variable. On failure this function returns NULL.

Note that the returned variable is marked as temporary and should be deleted when the variable is no longer needed. For more information on IDL RPC variables, see Client Variables.