[This is preliminary documentation and subject to change]

HttpRedirect

This metabase property specifies the directory or URL to which a client is redirected when attempting to access a specific resource. There are two general forms that the value for this property can take.

The simple format is Destination,Flag, where Destination can specify either a URL or a virtual path to a file. Flag can have one of three values: EXACT_DESTINATION indicates that the value provided for Destination should be considered an absolute target location; CHILD_ONLY indicates that the value should be added to the beginning of the file name of the request to be redirected; and PERMANENT indicates that this redirection will be permanent for this resource.

The more complex form of specification for this property involves the use of wildcards. The format is *; Wildcard1; Destination1; Wildcard2; Destination2, Flag. Each Wildcard; Destination pair indicates that requests matching the wildcard are redirected to the specified destination. Flag can have the same values as the simple string format.

Attribute NameAttribute Value
Data TypeSTRING
AttributesINHERIT
Default Valuenull
MetaFlagsExCACHE_PROPERTY_MODIFIED
User TypeIIS_MD_UT_FILE
StartingNumber
EndingNumber
ID6011

Access Locations

This property is accessible at the following locations:

Metabase PathIIS Admin Object Type
/LM/W3SVC/2IIsWebServer
/LM/W3SVC/Info/Templates/Public Web SiteIIsWebServer
/LM/W3SVC/Info/Templates/Secure Web SiteIIsWebServer
/LM/W3SVCIIsWebService
/LM/W3SVC/1/ROOTIIsWebVirtualDir
/LM/W3SVC/1/ROOT/_vti_binIIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISAdminIIsWebVirtualDir
/LM/W3SVC/1/ROOT/IISHelpIIsWebVirtualDir
/LM/W3SVC/1/ROOT/MSADCIIsWebVirtualDir
/LM/W3SVC/1/ROOT/ScriptsIIsWebVirtualDir
/LM/W3SVC/2/ROOTIIsWebVirtualDir
/LM/W3SVC/2/ROOT/IISAdminIIsWebVirtualDir

IIS Admin Base Object Information

The following table lists additional information required only for code that uses the IIS Admin Base Object.

Metabase identifier
MD_HTTP_REDIRECT
Data typeSTRING
User typeIIS_MD_UT_FILE

© 1997-2001 Microsoft Corporation. All rights reserved.