Microsoft Internet Security and Acceleration Server 2004 SDK

SkipNameResolutionForAccessAndRoutingRules Property of IFPCWebProxy[C++]

FPCWebProxy.SkipNameResolutionForAccessAndRoutingRules [Visual Basic]

[C++]

The SkipNameResolutionForAccessAndRoutingRules property gets or sets a Boolean value that indicates whether the ISA Server Web proxy will skip name resolution while checking access and routing rules. When name resolution is disabled in a forward proxy scenario with chaining, requests requiring DNS lookup on the downstream ISA Server computer are sent directly without delay to the chained upstream computer.

HRESULT get_SkipNameResolutionForAccessAndRoutingRules(
  VARIANT_BOOL* pfSkipNameResolutionForAccessAndRoutingRules
);

HRESULT put_SkipNameResolutionForAccessAndRoutingRules(
  VARIANT_BOOL fSkipNameResolutionForAccessAndRoutingRules
);

Parameters

pfSkipNameResolutionForAccessAndRoutingRules
Pointer to a Boolean variable that is set on return to VARIANT_TRUE if the Web proxy will skip name resolution while checking access and routing rules, or to VARIANT_FALSE if the Web proxy will not skip name resolution while checking access and routing rules.
fSkipNameResolutionForAccessAndRoutingRules
Boolean value that specifies whether the Web proxy will skip name resolution while checking access and routing rules.

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.

After the value of this property has been changed, and the change has been saved by calling the Save method, the Microsoft Firewall service must be restarted for the change to take effect. The Firewall service can be restarted by calling the IFPCArray::RestartServices method.

[Visual Basic]

The SkipNameResolutionForAccessAndRoutingRules property gets or sets a Boolean value that indicates whether the ISA Server Web proxy will skip name resolution while checking access and routing rules. When name resolution is disabled in a forward proxy scenario with chaining, requests requiring DNS lookup on the downstream ISA Server computer are sent directly without delay to the chained upstream computer.

Property SkipNameResolutionForAccessAndRoutingRules As Boolean

Property Value

Boolean value that indicates whether the Web proxy will skip name resolution while checking access and routing rules.

Remarks

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

After the value of this property has been changed, and the change has been saved by calling the Save method, the Microsoft Firewall service must be restarted for the change to take effect. The Firewall service can be restarted by calling the FPCArray.RestartServices method.

Example Code

This VBScript script sets the value of the SkipNameResolutionForAccessAndRoutingRules property so that the Web proxy will skip name resolution while checking access and routing rules. This script does not include error handling.

' Create the root object.
Dim root  ' The FPCLib.FPC root object
Set root = CreateObject("FPC.Root")

' Declare the other objects needed.
Dim array	 ' An FPCArray object
Dim webproxy  ' An FPCWebProxy object

' Get references to the array object
' and the Web proxy object. 
Set array = root.GetContainingArray()
set webproxy = array.ArrayPolicy.WebProxy

' Configure the Web proxy to skip name resolution
' while checking access and routing rules and save
' the new configuration. 
webproxy.SkipNameResolutionForAccessAndRoutingRules = True
webproxy.Save

' Restart the Firewall service so that
' the change will take effect.
array.RestartServices

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

FPCWebProxy