Microsoft Internet Security and Acceleration Server 2004 SDK

SendOriginalHostHeader Property of IFPCWebPublishingProperties[C++]

FPCWebPublishingProperties.SendOriginalHostHeader [Visual Basic]

[C++]

The SendOriginalHostHeader property gets or sets a Boolean value that indicates whether ISA Server sends the original HTTP Host header or a Host header corresponding to the name or IP address specified in the WebSite property of the rule.

HRESULT get_SendOriginalHostHeader(
  VARIANT_BOOL* pfSendOriginalHostHeader
);

HRESULT put_SendOriginalHostHeader(
  VARIANT_BOOL fSendOriginalHostHeader
);

Parameters

pfSendOriginalHostHeader
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if ISA Server sends the original HTTP Host header, or to VARIANT_FALSE if ISA Server sends a Host header corresponding to the name or IP address specified in the WebSite property of the rule.
fSendOriginalHostHeader
Boolean value that indicates whether ISA Server sends the original HTTP Host header or a Host header corresponding to the name or IP address specified in the WebSite property of the rule. The default value is VARIANT_FALSE.

Return Values

These property methods return S_OK if the call is successful; otherwise, they return an error code.

Remarks

This property is read/write. Its default value is VARIANT_FALSE.

This property cannot be set through ISA Server Management.

By default, ISA Server sends a Host header corresponding to the published site, that is, a Host header corresponding to the name or IP address specified in the WebSite property of the rule, rather than the original Host header that ISA Server received. However, there are scenarios where the published servers rely on the Host header to generate links on a page instead of generating relative links. These servers must receive the original Host header, which is recognized by the client. This property allows those servers to receive the original Host header.

[Visual Basic]

The SendOriginalHostHeader property gets or sets a Boolean value that indicates whether ISA Server sends the original HTTP Host header or a Host header corresponding to the name or IP address specified in the WebSite property of the rule.

Property SendOriginalHostHeader As Boolean

Property Value

Boolean value that indicates whether ISA Server sends the original HTTP Host header or a Host header corresponding to the name or IP address specified in the WebSite property of the rule. The default value is False.

Remarks

This property is read/write. Its default value is False.

This property cannot be set through ISA Server Management.

By default, ISA Server sends a Host header corresponding to the published site, that is, a Host header corresponding to the name or IP address specified in the WebSite property of the rule, rather than the original Host header that ISA Server received. However, there are scenarios where the published servers rely on the Host header to generate links on a page instead of generating relative links. These servers must receive the original Host header, which is recognized by the client. This property allows those servers to receive the original Host header.

Example Code

The following Visual Basic code fragment sets SendOriginalHostHeader to True for the first policy rule, which is assumed to be a Web publishing rule .

set root = CreateObject("FPC.Root")
set rule = root.GetContainingArray.ArrayPolicy.PolicyRules(1)
rule.WebPublishingProperties.SendOriginalHostHeader = True
rule.Save

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCWebPublishingProperties