wcExit( )

Syntax . . Returns . . Tips . . Program Example . . Related Topics . . A-Z Index . . Home

Frees the control handle and any memory that was allocated for the application.

Example

return wcExit(cntrlHandle);

Syntax

int wcExit(void *controlHandle)

controlHandle

The handle to the control structure.

Returns

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

Tips

You might call wcExit( ) after the application receives an ERR_MSGSHUTDOWN message. This message is returned by wcConOpen( ) when the Web browser session has timed out. This message notifies the application so it can perform cleanup tasks and exit. If the application does not cleanup and exit in response to this error message, INFORMIX-Universal Web Connect will terminate the application process automatically with no cleanup.

Program Example

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

int main(argc, argv)
        int     argc;
        char    **argv;
{
        void        *wcp;

        wcInit(argc, argv, &wcp);

        requestLoop();

        return wcExit(wcp);
}

In this code fragment, it is assumed that the function requestLoop( ) has been declared to handle user requests.