wcURL( )

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

Returns the URL that identifies this browser session's connection.

Example

returnCode = wcURL(cntrlHandle, &URL);

Syntax

int wcURL(void *controlHandle,
          char **URL)

controlHandle	The handle to the control structure.
URL	Out parameter used to return the URL.

Returns

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

Tips

This function is designed to be used internally by INFORMIX-Universal Web Connect to expand the $WEB_HOME variable, but you can also call it explicitly for your own purposes. Normally, wcURL( ) executes automatically to expand the variable $WEB_HOME. For example, wcURL( ) is called automatically when the following line is encountered in an AppPage:
```
<A HREF=$WEB_HOME?MIval=menu&last=smith>
```
Because there is no static value for the variable $WEB_HOME, INFORMIX-Universal Web Connect uses wcURL( ) to dynamically generate the value, which is the URL being used by the current browser session.
Works with any type of browser connection, whether the connection goes through a CGI driver module or connects directly to the application.

Program Example

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

If you are constructing HTML programmatically from within an event handler, you must perform this task explicitly, as shown in the following code. The eventFunction( ) is called to insert dynamic HTML tags when an <MIEVENT> tag is encountered in an AppPage.

int eventFunction( ) 
{
...
	wcPrintf("<A HREF=%s?MIval=menu&last=smith>", wcURL(wcp));
...
}

In this example, the URL is represented by the placeholder %s. This placeholder is replaced by the return value of wcURL( ).