Retrieves a server variable from the request data. Server variables provide information about the current request including info about the client application (browser, IP Address), the current request (server name, querystring), authentication (username, port accessing this app) and status information (Cookies, type of request) etc.
Most of the server variables that are returned are abstracted in method of this class, such as GetBrowser(), GetIPAddress(), GetAuthenticatedUsername() and so on.
To see a list of available raw server variables you can capture the current request output by bringing up the Web Connection Status form and saving request data for review.
The following shows typical contents of the ServerVariables available:
DLLVersion=Web Connection 3.32 (32 servers) wcConfig=d:\westwind\wconnect\wc.INI REQUEST_METHOD=GET PATH_INFO=/wconnect/slowhit.wcs PATH_TRANSLATED=d:\westwind\wconnect\slowhit.wcs SCRIPT_NAME=/wconnect/slowhit.wcs PHYSICAL_PATH=d:\westwind\wconnect\slowhit.wcs SERVER_PROTOCOL=HTTP/1.1 SERVER_SOFTWARE=Microsoft-IIS/4.0 SERVER_NAME=localhost SERVER_PORT=80 REMOTE_HOST=127.0.0.1 REMOTE_ADDR=127.0.0.1 AUTH_TYPE=Basic REMOTE_USER=rstrahl HTTP_AUTHORIZATION=Basic cnN0cmFobDpkc2ZhZG1z LOGON_USER=rstrahl HTTP_USER_AGENT=Mozilla/4.0 (compatible; MSIE 5.0; Windows NT; DigExt) HTTP_COOKIE=WWTHREADID=880U8OGY; ASPSESSIONIDGGGQQGCB=JNEHCPDAMLKOCNMEPLPNIBEH GMT_OFFSET=-36000 ALL_HTTP=HTTP_ACCEPT:*/*HTTP_ACCEPT_LANGUAGE:en-usHTTP_CONNECTION:Keep-AliveHTTP_HOST:localhostHTTP_USER_AGENT:Mozilla/4.0 (compatible; MSIE 5.0; Windows NT; DigExt)HTTP_COOKIE:WWTHREADID=880U8OGY; ASPSESSIONIDGGGQQGCB=JNEHCPDAMLKOCNMEPLPNIBEHHTTP_AUTHORIZATION:Basic cnN0cmFobDpkc2ZhZG1zHTTP_ACCEPT_ENCODING:gzip, deflate
Note: PHYSICAL_PATH, DLLVersion and wcConfig are specific to Web Connection.
Note that Web Connection pulls specific keys out of the HTTP request buffer so not all HTTP variables are necessarily available. Web Connection pulls the most common ones that you are most likely to require for your applications. However, later versions of IIS or special extensions running on the Web Server might add additional HTTP variables to the Web Server. You can access these by telling wc.dll to specifically pull these values for each request by using the wc.ini [Extra Server Variables] section. For more info see the wc.ini topic.
o.servervariables(lcKey)
Return Value
String value of the server variable or "" if it doesn't exist or is empty.
Parameters
lcKey
Name of the server variable to return
See also:
Class wwrequest | wwRequest::QueryString | wwRequest::Form | The Server Status Form© West Wind Technologies, 1996-2024 • Updated: 07/26/01
Comment or report problem with topic