w3GetCgi

Syntax   Parameters

w3GetCgi returns the value of any named CGI parameter.  CGI Parameters are:

AUTH_TYPE

The authentication method used to validate the user.  This is typically not used with FlashCONNECT.

CONTENT_LENGTH

Length of the input from the browser.

CONTENT_TYPE

The MIME content-type of the data in a form.

GATEWAY_INTERFACE

Contains the version of the CGI specification that the server uses.

HTTP_ACCEPT

Enumerates the MIME formats the browser can accept.

HTTP_USER_AGENT

Name and version of user's browser.

PATH_INFO

Another way of passing information to the CGI script.  This is not used by FlashCONNECT, however, it is available if you wish to use it.

PATH_TRANSLATED

See PATH_INFO.

QUERY_STRING

The parameter string from the browser.  It contains the original name/value pairs.  This information is pre-parsed by FlashCONNECT, and is available using the w3GetVal() subroutine.

REMOTE_ADDR

The IP address of the browser.  Unfortunately, you can not be certain that there is a one-to-one correspondence between browsers and IP addresses.  For example, all browsers behind a firewall will look like they have the same IP address.

REMOTE_HOST

The DNS name of the browser's machine.  This will probably be blank.

REQUEST_METHOD

How information is passed to the CGI program, either POST or GET.  This is used internally by FlashCONNECT to retrieve the Name/Value pairs. Your application should not need to use it.

SCRIPT_NAME

The name of the CGI program in use.  This is used by the w3Action subroutine to generate a URL to get back to the currently running application.

SERVER_NAME

Contains the server's host name or IP address.  This is typically used for building self-referencing URLs.  The w3Action() subroutine uses this CGI variable to build a complete URL back to the current application.

SERVER_PORT

The TCP/IP port number on which the request came in.  The stardard port number for HTTP is 80.

SERVER_PROTOCOL

The protocol (HTTP) and version (1.0 or 1.1) that the server uses.

SERVER_SOFTWARE

Name and version of the server software.

HTTP_COOKIE

Name and value of any cookies.

HTTP_HOST

Web server alias name, if any.

 

In case D3 is operating in a case sensitive mode, all CGI parameter names and requested names are converted to upper case before extraction.

Syntax

call w3GetCgi (val, name)

Parameters

val

Out

The value is returned here.

name

In

The name of the parameter.