226 lines
31 KiB
HTML
226 lines
31 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
|
||
|
|
||
|
<html>
|
||
|
|
||
|
<head>
|
||
|
<title>Microsoft Index Server Guide: Variables in .idq and .htx Files</title>
|
||
|
<meta name="FORMATTER" content="Microsoft FrontPage 1.1">
|
||
|
<meta name="FORMATTER" content="Microsoft FrontPage 1.1">
|
||
|
<meta name="GENERATOR" content="Microsoft FrontPage 1.1">
|
||
|
</head>
|
||
|
|
||
|
<body bgcolor="#FFFFFF">
|
||
|
<!--Headerbegin--><p align=center><a name="TOP"><img src="onepix.gif" alt="Space" align=middle width=1 height=1></a> <a href="default.htm#Top"><img src="toc.gif" alt=" Contents" align=middle border=0 width=89 height=31></a> <a href="htxhelp.htm"><img src="previous.gif" alt="Previous" align=middle border=0 width=32 height=31></a> <a href="adminhlp.htm"><img src="next.gif" alt="Next" align=middle border=0 width=32 height=31></a> </p>
|
||
|
<hr>
|
||
|
<!--Headerend--><p><a name="Variablesin.idqand.htx
|
||
|
Files"><font size=6><strong>Variables in .idq and .htx Files</strong></font></a></p>
|
||
|
<p align=left><!--Chaptoc--></p>
|
||
|
<blockquote>
|
||
|
<p><a href="idq-vars.htm#Read-OnlyVariablesAvailablein.htxFiles">Read-Only Variables Available in .htx Files</a> <br>
|
||
|
<a href="idq-vars.htm#VariablesThatAreSettableinFormsAndin.idqFiles">Variables that Are Settable in Forms and in .idq Files</a> <br>
|
||
|
<a href="idq-vars.htm#StringVariablesUsefulforFormattingDisplayedColumns">String Variables Useful for Formatting Displayed Columns</a> <br>
|
||
|
<a href="idq-vars.htm#ParameterforUsewithBookmarks">Parameter for Use with Bookmarks</a> <br>
|
||
|
<a href="idq-vars.htm#StandardCGIVariablesAvailable">Standard CGI Variables Available</a> <br>
|
||
|
<a href="idq-vars.htm#ValidLocaleIdentifiers">Valid Locale Identifiers</a> <br>
|
||
|
</p>
|
||
|
</blockquote>
|
||
|
<hr>
|
||
|
<!--ChaptocEnd--><h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="Read-OnlyVariablesAvailablein.htxFiles">Read-Only Variables Available in .htx Files</a></h1>
|
||
|
<p>The following variables are available for use in .htx files. These are set based upon the results of the search. In addition, the
|
||
|
other IDQ variables mentioned below can be used in the .htx file. In the detail section of the .htx file, any output columns
|
||
|
mentioned in the <b>CiColumns</b> can also be used. </p>
|
||
|
<p><strong>Read-Only Variables Available in .htx Files:</strong></p>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=20%><font size=2><strong>Variable Name</strong></font></th><th align=left valign=bottom width=80%><font size=2><strong>Meaning</strong></font></th></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiBookmark</font></td><td valign=top width=80%><font size=2>Reference to the first row on the page. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiContainsFirstRecord</font></td><td valign=top width=80%><font size=2>Set to 1 if this page contains the first record of the query results; 0 otherwise. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiContainsLastRecord </font></td><td valign=top width=80%><font size=2>Set to 1 if this page contain the last record of the query results; 0 otherwise. For a sequential query, this will not
|
||
|
be accurate until after the <!--VERMEER BOT=HTMLMarkup StartSpan --><font size=3><code><%</code></font><!--VERMEER BOT=HTMLMarkup EndSpan --></font><font size=3><code>enddetail<!--VERMEER BOT=HTMLMarkup StartSpan --><font size=3><code>%></code></font><!--VERMEER BOT=HTMLMarkup EndSpan --></code></font><font size=2> section in the .htx file. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiCurrentPageNumber</font></td><td valign=top width=80%><font size=2>Current page number of query results (that is, page number <em>x</em> of <em>y</em> pages). </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiCurrentRecordNumber</font></td><td valign=top width=80%><font size=2>Number displayed for current record. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiErrorMessage</font></td><td valign=top width=80%><font size=2>Error message. Available only for error pages. See the </font><a href="errorhlp.htm"><font size=2>Error Messages</font></a><font size=2> page for possible error messages.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiErrorNumber</font></td><td valign=top width=80%><font size=2>Error number. Available only for error pages.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiFirstRecordNumber</font></td><td valign=top width=80%><font size=2>Record number of first record on a page. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiLastRecordNumber</font></td><td valign=top width=80%><font size=2>Last record number on a page. For a sequential query, this will not be accurate until after the <br>
|
||
|
<!--VERMEER BOT=HTMLMarkup StartSpan --><font size=3><code><%</code></font><!--VERMEER BOT=HTMLMarkup EndSpan --></font><font size=3><code>enddetail<!--VERMEER BOT=HTMLMarkup StartSpan --><font size=3><code>%></code></font><!--VERMEER BOT=HTMLMarkup EndSpan --></code></font><font size=2> section in the .htx file. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiMatchedRecordCount"><font size=2>CiMatchedRecordCount</font></a></td><td valign=top width=80%><font size=2>Total number of records matching a query. <em>Referring to this variable from the .htx file will force the search to
|
||
|
use a </em></font><a href="idqhelp.htm#SeqQuery"><font size=2><em>nonsequential query</em></font></a><font size=2><em>. </em></font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiOutOfDate"><font size=2>CiOutOfDate</font></a></td><td valign=top width=80%><font size=2>Set to 1 if the content index out of date; 0 otherwise. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiQueryIncomplete"><font size=2>CiQueryIncomplete</font></a></td><td valign=top width=80%><font size=2>Set to 1 if the query could not be resolved using the content index and <b>CiForceUseCI</b> was set; 0 otherwise. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiQueryTimedOut</font></td><td valign=top width=80%><font size=2>Set to 1 if the query exceeded the time limit for execution; 0 otherwise. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiQueryDate</font></td><td valign=top width=80%><font size=2>Date (at the Web server) the query was executed. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiQueryTime</font></td><td valign=top width=80%><font size=2>Time (at the Web server) the query was executed. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiQueryTimeZone</font></td><td valign=top width=80%><font size=2>Time zone of the Web server.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiRecordsNextPage"><font size=2>CiRecordsNextPage</font></a></td><td valign=top width=80%><font size=2>Number of records on the next page. <em>Referring to this variable from the .htx file will force the search to use a
|
||
|
</em></font><a href="idqhelp.htm#SeqQuery"><font size=2><em>nonsequential query</em></font></a><font size=2><em>. </em></font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiTotalNumberPages"><font size=2>CiTotalNumberPages</font></a></td><td valign=top width=80%><font size=2>Total number of pages used to contain query results. <em>Referring to this variable from the .htx file will force the
|
||
|
search to use a </em></font><a href="idqhelp.htm#SeqQuery"><font size=2><em>nonsequential query</em></font></a><font size=2><em>. </em></font></td></tr>
|
||
|
</table>
|
||
|
<hr>
|
||
|
<h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="VariablesThatAreSettableinFormsAndin.idqFiles">Variables that Are Settable in Forms and in .idq Files</a></h1>
|
||
|
<p>Following is the set of variables that can be set in the .idq file or as CGI variables and referred to in the .htx file. They can also
|
||
|
be set as variables in forms, or given as parameters to a direct execution of the .idq file. </p>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=20%><font size=2><b>Variable Name</b></font> </th><th align=left valign=bottom width=80%><font size=2><b>Meaning</b></font></th></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiCatalog"><font size=2>CiCatalog</font></a></td><td valign=top width=80%><font size=2>Override for the location of the catalog; defaults to the </font><a href="reghelp.htm#IsapiDefaultCatalogDirectory"><font size=2>registry parameter</font></a><font size=2> if it is set, or to <b>CiScope</b> otherwise. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiColumns</font></td><td valign=top width=80%><font size=2>List of output columns available in the .htx file. Format is a series of columns named by </font><a href="idqhelp.htm#namesection"><font size=2>friendly names</font></a><font size=2> and
|
||
|
separated by commas. Up to 50 output columns can be referred to in a single query. Properties cannot be
|
||
|
duplicated. Different friendly names for the same property are considered duplicates.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiDeferNonIndexedTrimming"><font size=2>CiDeferNonIndexedTrimming</font></a></td><td valign=top width=80%><font size=2>Some trimming of query results may be performed on individual objects after using the index to locate potential
|
||
|
matches. Common post-processing includes trimming to match scope, and security. When a query sorted in
|
||
|
descending order by rank is run, the full set of objects is examined to locate the <strong>CiMaxRecordsInResultSet</strong> top
|
||
|
records. Because the top records cannot include items that fail post-index trimming, many thousands of items
|
||
|
may have to be examined and thrown out to find the top results of a particular query, which can be very
|
||
|
resource-intensive. Setting <strong>CiDeferNonIndexedTrimming</strong> to <strong>TRUE</strong> will first find the <strong>CiMaxRecordsInResultSet</strong>
|
||
|
top records in the entire index, and then trim only that set. <em>When this variable is set to </em><em><strong>TRUE</strong></em><em>, the number of
|
||
|
results returned to the user may be less than CiMaxRecordsInResultSet, even if that many records match the
|
||
|
query. The missing results will always be of lower rank than those returned. Although fewer results may be
|
||
|
returned than expected, the best results will always be returned.</em></font><p><font size=2>This flag should only be set when the scope of a query is set to the virtual root </font><font size=3><code>(CiScope = /)</code></font><font size=2> and there is a
|
||
|
reasonable expectation that queries are pure content queries (no </font><a href="qrylang.htm#PropertyValueQueries"><font size=2>property value</font></a><font size=2> clause) and most results are
|
||
|
accessible to the user. On a public Web site, this will be a common scenario. </font></p>
|
||
|
</td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiFlags</font></td><td valign=top width=80%><font size=2>Query flags specifying the depth of search. <tt>DEEP</tt> means the directory given in <b>CiScope</b> and all directories below
|
||
|
it, <tt>SHALLOW</tt> means only the directory specified in <b>CiScope</b>.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiForceUseCi"><font size=2>CiForceUseCi</font></a></td><td valign=top width=80%><font size=2>If <strong>TRUE</strong>, query will be forced to use the content index, even if the content index is out of date.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiLocale"><font size=2>CiLocale</font></a></td><td valign=top width=80%><font size=2>Defines the locale used to issue the query. </font><a href="#ValidLocaleIdentifiers"><font size=2>Standard HTML locale encoding</font></a><font size=2> is supported.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiMaxRecordsInResultSet"><font size=2>CiMaxRecordsInResultSet</font></a></td><td valign=top width=80%><font size=2>Maximum number of query results to return from a query.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiMaxRecordsPerPage </font></td><td valign=top width=80%><font size=2>Maximum number of records to display on a page. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiRestriction</font></td><td valign=top width=80%><font size=2>Query restriction, a description of what to search for. To display this on a page, or to use this in a URL with a
|
||
|
query expression, see </font><a href="htxhelp.htm#escapes"><font size=2>Syntax</font></a><font size=2> on the “HTML Extension File” page.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiScope</font></td><td valign=top width=80%><font size=2>Scope, the starting directory for the search as either a virtual or physical path name. To use this in a URL with a
|
||
|
query expression, see </font><a href="htxhelp.htm#escapes"><font size=2>Syntax</font></a><font size=2> on the “HTML Extension File” page.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiSort"><font size=2>CiSort</font></a></td><td valign=top width=80%><font size=2>Sort specification. Format is a series of columns named by </font><a href="idqhelp.htm#namesection"><font size=2>friendly names</font></a><font size=2> and followed by either </font><font size=3><code>[a]</code></font><font size=2> for
|
||
|
ascending order or </font><font size=3><code>[d]</code></font><font size=2> for descending order. The primary sort column is listed first, for example,
|
||
|
</font><font size=3><code>CiSort=Rank[d], FileName[a]</code></font><font size=2>. <em>Setting this variable may force the search to use a nonsequential
|
||
|
query.</em></font></td></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiTemplate"><font size=2>CiTemplate</font></a></td><td valign=top width=80%><font size=2>Output template (.htx) file path name (as a virtual path name). This path name must be a complete path name from
|
||
|
the virtual root with no “.” or “..” components.</font></td></tr>
|
||
|
</table>
|
||
|
<hr>
|
||
|
<h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="StringVariablesUsefulforFormattingDisplayedColumns">String Variables Useful for Formatting Displayed
|
||
|
Columns</a></h1>
|
||
|
<p>The variables below, like those in the table above, may be set in the .idq file, but they may not refer to other parameters. They
|
||
|
cannot be referred to in the .htx file, but are used only to format columns whose type is a vector. </p>
|
||
|
<p><strong>Variables for Formatting Columns with Vectors:</strong></p>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=20%><font size=2><b>Variable Name</b></font> </th><th align=left valign=bottom width=80%><font size=2><b>Meaning</b></font></th></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiBoolVectorPrefix</font></td><td valign=top width=80%><font size=2>String printed prior to vectors of Boolean values</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiBoolVectorSeparator</font></td><td valign=top width=80%><font size=2>String printed between elements of vectors of Boolean values </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiBoolVectorSuffix</font></td><td valign=top width=80%><font size=2>String printed after vectors of Boolean values </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiCurrencyVectorPrefix</font></td><td valign=top width=80%><font size=2>String printed prior to vectors of currency values </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiCurrencyVectorSeparator</font></td><td valign=top width=80%><font size=2>String printed between elements of vectors of currency values </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiCurrencyVectorSuffix</font></td><td valign=top width=80%><font size=2>String printed after vectors of currency values </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiDateVectorPrefix</font></td><td valign=top width=80%><font size=2>String printed prior to vectors of dates </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiDateVectorSeparator</font></td><td valign=top width=80%><font size=2>String printed between elements of vectors of dates </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiDateVectorSuffix</font></td><td valign=top width=80%><font size=2>String printed after vectors of dates </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiNumberVectorPrefix</font></td><td valign=top width=80%><font size=2>String printed prior to vectors of numbers </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiNumberVectorSeparator</font></td><td valign=top width=80%><font size=2>String printed between elements of vectors of numbers </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiNumberVectorSuffix</font></td><td valign=top width=80%><font size=2>String printed after vectors of numbers </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiStringVectorPrefix</font></td><td valign=top width=80%><font size=2>String printed prior to vectors of strings </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiStringVectorSeparator</font></td><td valign=top width=80%><font size=2>String printed between elements of vectors of strings </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CiStringVectorSuffix</font></td><td valign=top width=80%><font size=2>String printed after vectors of strings </font></td></tr>
|
||
|
</table>
|
||
|
<hr>
|
||
|
<h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="ParameterforUsewithBookmarks">Parameter for Use with Bookmarks</a></h1>
|
||
|
<p>The <strong>CiBookmarkSkipCount</strong> variable (described in the next table) is used in conjunction with <b>CiBookmark</b> to set an offset
|
||
|
from the previous page of the query. It cannot be set in the .idq file; it should be set as a form variable. See <a href="htxhelp.htm#pagenav">Navigating
|
||
|
Between Pages in Query Results</a> on the “HTML Extension Files” page for examples. </p>
|
||
|
<p>The following variable can be set as a CGI variable, for navigating between pages:</p>
|
||
|
<div align=left>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=20%><font size=2><b>Variable Name</b></font> </th><th align=left valign=bottom width=80%><font size=2><b>Meaning</b></font></th></tr>
|
||
|
<tr><td valign=top width=20%><a name="CiBookmarkSkipCount"><font size=2>CiBookmarkSkipCount</font></a></td><td valign=top width=80%><font size=2>Signed number of rows to skip for the next page. Negative means skip backward, positive means skip forward. </font></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<hr>
|
||
|
<h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="StandardCGIVariablesAvailable">Standard CGI Variables Available</a></h1>
|
||
|
<p>The variables below are normally set by CGI program execution and can be referred to in the .idq or .htx files. </p>
|
||
|
<p><strong>Variables Available from CGI Parameters:</strong></p>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=20%><font size=2><b>HTTP Variable</b></font> </th><th align=left valign=bottom width=80%><font size=2><b>Meaning</b></font></th></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>ALL_HTTP</font></td><td valign=top width=80%><font size=2>All HTTP headers that were not already parsed into one of the listed variables. These variables are of the form
|
||
|
HTTP_<em>header field name</em> with each variable separated by \r\n, for example: <br>
|
||
|
</font><font size=3><tt>HTTP_ACCEPT: */*, q=0.300, audio/x-aiff, audio/basic, image/jpeg,
|
||
|
image/gif, text/plain, text/html<br>
|
||
|
</tt><code>HTTP_USER_AGENT: Microsoft Internet Explorer/0.1 (Win32)<br>
|
||
|
HTTP_REFERER: http://webserver/samples/dbsamp/dbsamp3.htm<br>
|
||
|
HTTP_CONTENT_TYPE: application/x-www-form-urlenPRE: 10<br>
|
||
|
HTTP_EXTENSION: Security/Digest </code></font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>AUTH_TYPE </font></td><td valign=top width=80%><font size=2>The type of authorization in use. If the user name has been authenticated by the server, this will contain Basic.
|
||
|
Otherwise, it will not be present. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CONTENT_LENGTH</font></td><td valign=top width=80%><font size=2>The number of bytes that the script can expect to receive from the client. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>CONTENT_TYPE</font></td><td valign=top width=80%><font size=2>The content type of the information supplied in the body of a POST request. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>GATEWAY_INTERFACE</font></td><td valign=top width=80%><font size=2>The revision of the CGI (Common Gateway Interface) specification with which this server complies. The current
|
||
|
version is CGI/1.1. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>HTTP_ACCEPT</font></td><td valign=top width=80%><font size=2>Special-case HTTP header. Values of the Accept: fields are concatenated, separated by “,”; for example, if the
|
||
|
following lines are part of the HTTP header: </font><font size=3><code>accept: */*; q=0.1 accept: text/html accept:
|
||
|
image/jpeg</code></font><font size=2> then the <strong>HTTP_ACCEPT</strong> variable will have a value of: </font><font size=3><code>*/*; q=0.1, text/html,
|
||
|
image/jpeg</code></font><font size=2>.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>PATH_INFO</font></td><td valign=top width=80%><font size=2>Additional path information, as given by the client. This comprises the trailing part of the URL after the script
|
||
|
name but before the query string (if any). </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>PATH_TRANSLATED</font></td><td valign=top width=80%><font size=2>This is the value of <strong>PATH_INFO</strong>, but with any virtual path name expanded into a directory specification. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>QUERY_STRING</font></td><td valign=top width=80%><font size=2>The information which follows the question mark (?) in the URL that referenced this script. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>REMOTE_ADDR</font></td><td valign=top width=80%><font size=2>The IP address of the client.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>REMOTE_HOST</font></td><td valign=top width=80%><font size=2>The hostname of the client.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>REMOTE_USER</font></td><td valign=top width=80%><font size=2>This contains the user name supplied by the client and authenticated by the server. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>REQUEST_METHOD </font></td><td valign=top width=80%><font size=2>The HTTP request method.</font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>SCRIPT_NAME</font></td><td valign=top width=80%><font size=2>The name of the script program being run. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>SERVER_NAME</font></td><td valign=top width=80%><font size=2>The server’s hostname (or IP address) as it should appear in self-referencing URLs. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>SERVER_PORT</font></td><td valign=top width=80%><font size=2>The TCP/IP port on which the request was received. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>SERVER_PROTOCOL</font></td><td valign=top width=80%><font size=2>The name and version of the information-retrieval protocol relating to this request, usually HTTP/1.0. </font></td></tr>
|
||
|
<tr><td valign=top width=20%><font size=2>SERVER_SOFTWARE</font></td><td valign=top width=80%><font size=2>The name and version of the Web server under which the Internet Server Extension is running. </font></td></tr>
|
||
|
</table>
|
||
|
<hr>
|
||
|
<h1><a href="#TOP"><img src="up.gif" alt="To Top" align=middle border=0 width=14 height=11></a><a name="ValidLocaleIdentifiers">Valid Locale Identifiers</a></h1>
|
||
|
<p align=left><strong>Valid Locale Identifiers for Use in CiLocale:</strong></p>
|
||
|
<div align=left>
|
||
|
<table border=1 cellpadding=5 cellspacing=0 width=100%>
|
||
|
<tr><th align=left valign=bottom width=30%><font size=2>Language</font></th><th align=left valign=bottom width=20%><font size=2>CiLocale String</font></th><th align=left valign=bottom width=50%><font size=2>Win32 Equivalent</font></th></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Chinese</font></td><td valign=top width=20%><font size=3><code>ZH, ZH-CN, ZH-TW</code></font></td><td valign=top width=50%><font size=3><code>LANG_CHINESE | SUBLANG_CHINESE_SIMPLIFIED</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Bulgarian</font></td><td valign=top width=20%><font size=3><code>BG</code></font></td><td valign=top width=50%><font size=3><code>LANG_BULGARIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Croatian</font></td><td valign=top width=20%><font size=3><code>HR</code></font></td><td valign=top width=50%><font size=3><code>LANG_CROATIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Czech</font></td><td valign=top width=20%><font size=3><code>CS</code></font></td><td valign=top width=50%><font size=3><code>LANG_CZECH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Danish</font></td><td valign=top width=20%><font size=3><code>DA</code></font></td><td valign=top width=50%><font size=3><code>LANG_DANISH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Dutch</font></td><td valign=top width=20%><font size=3><code>NL</code></font></td><td valign=top width=50%><font size=3><code>LANG_DUTCH | SUBLANG_DUTCH</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>English (Great Britain)</font></td><td valign=top width=20%><font size=3><code>EN-GB</code></font></td><td valign=top width=50%><font size=3><code>LANG_ENGLISH | SUBLANG_ENGLISH_UK</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>English (US)</font></td><td valign=top width=20%><font size=3><code>EN, EN-US</code></font></td><td valign=top width=50%><font size=3><code>LANG_ENGLISH | SUBLANG_ENGLISH_US</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Finnish</font></td><td valign=top width=20%><font size=3><code>FI</code></font></td><td valign=top width=50%><font size=3><code>LANG_FINNISH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>French</font></td><td valign=top width=20%><font size=3><code>FR, FR-FR</code></font></td><td valign=top width=50%><font size=3><code>LANG_FRENCH | SUBLANG_FRENCH</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>French (Canadian)</font></td><td valign=top width=20%><font size=3><code>FR-CA</code></font></td><td valign=top width=50%><font size=3><code>LANG_FRENCH | SUBLANG_FRENCH_CANADIAN</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>German</font></td><td valign=top width=20%><font size=3><code>DE</code></font></td><td valign=top width=50%><font size=3><code>LANG_GERMAN | SUBLANG_GERMAN</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Greek</font></td><td valign=top width=20%><font size=3><code>EL</code></font></td><td valign=top width=50%><font size=3><code>LANG_GREEK | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Icelandic</font></td><td valign=top width=20%><font size=3><code>IS</code></font></td><td valign=top width=50%><font size=3><code>LANG_ICELANDIC | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Italian</font></td><td valign=top width=20%><font size=3><code>IT</code></font></td><td valign=top width=50%><font size=3><code>LANG_ITALIAN | SUBLANG_ITALIAN</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Japanese</font></td><td valign=top width=20%><font size=3><code>JA</code></font></td><td valign=top width=50%><font size=3><code>LANG_JAPANESE | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Korean</font></td><td valign=top width=20%><font size=3><code>KO</code></font></td><td valign=top width=50%><font size=3><code>LANG_KOREAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Neutral (use built-in word breaking)</font></td><td valign=top width=20%><font size=3><code>NEUTRAL</code></font></td><td valign=top width=50%><font size=3><code>LANG_NEUTRAL | SUBLANG_NEUTRAL</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Norwegian</font></td><td valign=top width=20%><font size=3><code>NO</code></font></td><td valign=top width=50%><font size=3><code>LANG_NORWEGIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Polish</font></td><td valign=top width=20%><font size=3><code>PL</code></font></td><td valign=top width=50%><font size=3><code>LANG_POLISH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Portuguese</font></td><td valign=top width=20%><font size=3><code>PT</code></font></td><td valign=top width=50%><font size=3><code>LANG_PORTUGUESE | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Portuguese (Brazilian)</font></td><td valign=top width=20%><font size=3><code>PT-BR</code></font></td><td valign=top width=50%><font size=3><code>LANG_PORTUGUESE | SUBLANG_PORTUGUESE_BRAZILIAN</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Romanian</font></td><td valign=top width=20%><font size=3><code>RO</code></font></td><td valign=top width=50%><font size=3><code>LANG_ROMANIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Russian</font></td><td valign=top width=20%><font size=3><code>RU</code></font></td><td valign=top width=50%><font size=3><code>LANG_RUSSIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Slovak</font></td><td valign=top width=20%><font size=3><code>SK</code></font></td><td valign=top width=50%><font size=3><code>LANG_SLOVAK | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Slovenian</font></td><td valign=top width=20%><font size=3><code>SL</code></font></td><td valign=top width=50%><font size=3><code>LANG_SLOVENIAN | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Spanish</font></td><td valign=top width=20%><font size=3><code>ES, ES-ES</code></font></td><td valign=top width=50%><font size=3><code>LANG_SPANISH | SUBLANG_SPANISH</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Swedish</font></td><td valign=top width=20%><font size=3><code>SV</code></font></td><td valign=top width=50%><font size=3><code>LANG_SWEDISH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
<tr><td valign=top width=30%><font size=2>Turkish</font></td><td valign=top width=20%><font size=3><code>TR</code></font></td><td valign=top width=50%><font size=3><code>LANG_TURKISH | SUBLANG_DEFAULT</code></font></td></tr>
|
||
|
</table>
|
||
|
</div>
|
||
|
<p>CiLocale can be specified in the .idq or .ida file. It can also be specified by the browser as the
|
||
|
HTTP_ACCEPT_LANGUAGE tag. Values entered in the .idq and .ida files supersede those sent in
|
||
|
HTTP_ACCEPT_LANGUAGE. If no value is found in the .idq or .ida file, the value of HTTP_ACCEPT_LANGUAGE is
|
||
|
parsed from left to right to find a supported language.</p>
|
||
|
<p>For example:</p>
|
||
|
<blockquote>
|
||
|
<pre>HTTP_ACCEPT_LANGUAGE=EN, FR, CZ</pre>
|
||
|
</blockquote>
|
||
|
<p><strong>Note</strong>   Values are separated by commas.</p>
|
||
|
<!--Footerbegin--><hr>
|
||
|
<p align=center><a href="default.htm#Top"><img src="toc.gif" alt=" Contents" align=middle border=0 width=89 height=31></a> <a href="htxhelp.htm"><img src="previous.gif" alt="Previous" align=middle border=0 width=32 height=31></a> <a href="#TOP"><img src="up_end.gif" alt="To Top" align=middle border=0 width=32 height=31></a> <a href="adminhlp.htm"><img src="next.gif" alt="Next" align=middle border=0 width=32 height=31></a> </p>
|
||
|
<hr>
|
||
|
<p align=center><em>© 1996 by Microsoft Corporation. All rights reserved.<!--Footerend--></em></p>
|
||
|
</body>
|
||
|
|
||
|
</html>
|