vtiGetWebMetaInfo

C++: CString vtiGetWebMetaInfo(LPCTSTR szKey);

VB: vtiGetWebMetaInfo(Key as String) as String

Description

This method looks up a key in the web’s meta-info dictionary and returns its value. All keys beginning with the characters “vti_” are reserved. See vtiPutWebMetaInfo for a description of how to define your own web variables. The FrontPage Server Extensions define and maintain the following read-only meta-info keys:

   vti_autorecalc         example: “1”
   vti_casesensitiveurls      example: “1”
   vti_extenderversion      example: “1.1.1.40”
   vti_featurelist      example: “vti_ServiceRename”
   vti_htmlextensions      example: “.html.htm.htm.”
   vti_httpdversion      example: “Apache/0.6.5”
   vti_longfilenames      example: “1”
   vti_retartmanual      example: “0”
   vti_textextensions      example: “.txt.”
   vti_timecreated      example: “28 Jun 1995 20:21:11 EDT”
   vti_welcomenames      example: “index.html index.htm”

The keys in FrontPage dictionaries are case-sensitive, and all built-in keys are now all lower-case. Wizards written for FrontPage 1.1 should be changed to always use all lower-case when accessing built-in keys. All time variables are stored in RFC 1123 format. Boolean variables are either “0” (False) or “1” (True). Extensions are reported as a string separated and terminated by dots (“.”). Multiple values are separated by spaces. The following are notes on particular keys:

• vti_autorecalc is the variable that is manipulated by vtiSetWebRecalcDependencies and is not always present
  
  
• vti_casesensitiveurls is false if the server doesn’t see any difference between URLs like “INDEX.HTM” and “index.htm” (such as on Windows-based servers), and true if it does
  
  
• vti_featurelist is a space-separated list of features that are not supported by the current web or web server. Typically, this string is empty. Possible values in this list include vti_ServiceRename, vti_ServiceRemove, vti_ACAll, vti_ACRegisteredEndUsers, vti_ACIPAddresses, and vti_ACCreateNewUsers. The prefix AC refers to Access Control.
  
  
• vti_htmlextensions and vti_textextensions show what the server expects for filename endings for HTML and plain-text files, respectively; each list is terminated with a dot (‘.’)
  
  
• vti_longfilenames is true if the server supports filenames longer than the DOS 8.3 convention
  
  
• vti_restartmanual is true if the HTTPD server program must be restarted every time a new web is created; some web servers cannot be forced to re-read their configuration files while running
  
  
• vti_welcomenames is a space-separated list, in order, of all the default “home page” names for the current web; this is the page returned when the server is asked for the web directory URL rather than a specific page in the web (example: a request for “http://www.microsoft.com” returns the page “http://www.microsoft.com/index.htm”)

Return Value

The value of the requested key, or the empty string if no such key exists.

Parameters

Key is the name of the meta-info value to retrieve.