wcDropVariable( )

Drop a particular variable.

Example

returnCode = wcDropVariable(cntrlHandle, "$customerSelection");

int wcDropVariable(void *wcp, 
                   char *varname)

wcp	The handle to the control structure.
varName	Name of the variable for which you want to drop.

0	Success.
Error code	Failure or exception. For a list of possible error codes, see Error Messages.

All session variables are accessible to wcDropVariable( ). For example, the variable can be an environment variable, a parameter in the configuration file, a variable passed to the application from an HTML form, a variable set through wcSetVariable( ), a variable passed as a parameter to WebExplode( ), a variable set as a side effect of some operation such as an MISQL tag, or a variable from an MIVAR tag.

The following code shows how wcDropVariable( ) is used in an application.


    wcGetVariable(wcp, "$MIval", &mival);

    if (mival==NULL)
        wcDropVariable(wcp, "$MIval");