SkipNameResolutionForAccessAndRoutingRules Property of the IFPCWebProxy Interface
The SkipNameResolutionForAccessAndRoutingRules property gets or sets a Boolean value that indicates whether the Forefront TMG 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 Forefront TMG computer are sent directly without delay to the chained upstream computer.
C++
HRESULT put_SkipNameResolutionForAccessAndRoutingRules(
VARIANT_BOOL fSkipNameResolutionForAccessAndRoutingRules
);
HRESULT get_SkipNameResolutionForAccessAndRoutingRules(
VARIANT_BOOL* pfSkipNameResolutionForAccessAndRoutingRules
);
Parameters
fSkipNameResolutionForAccessAndRoutingRules
Boolean value that specifies whether the Web proxy will skip name resolution while checking access and routing rules.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.
Return Value
These property methods return S_OK if the call is successful; otherwise, they return an error code.
Visual Basic
Property SkipNameResolutionForAccessAndRoutingRules As Boolean
Property Value
Boolean value that indicates whether the Web proxy will skip name resolution while checking access and routing rules.
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 isaArray ' An FPCArray object
Dim webProxy ' An FPCWebProxy object
Dim restartMask ' A 32-bit bitmask of type FpcServices
' Get references to the array object
' and the Web proxy object.
Set isaArray = root.GetContainingArray()
Set webProxy = isaArray.ArrayPolicy.WebProxy
' Configure the Web proxy to skip name resolution
' while checking access and routing rules and save
' the new configuration.
webProxy.SkipNameResolutionForAccessAndRoutingRules = True
restartMask = webProxy.GetServiceRestartMask
webProxy.Save
' Restart the Firewall service so that
' the change will take effect.
isaArray.RestartServices restartMask
Remarks
This property is read/write. Its default value is False (VARIANT_FALSE in C++).
After the value of this property has been modified, the change must be written to persistent storage by calling the Save method, and the Microsoft Firewall service must be restarted for the change to take effect. For more information about restarting the Firewall service to apply changes, see Restarting Services After Configuration Changes.
This property cannot be set through Forefront TMG Management.
Requirements
Client | Requires Windows 7 or Windows Vista. |
Server | Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2. |
Version | Requires Forefront Threat Management Gateway (TMG) 2010. |
IDL | Declared in Msfpccom.idl. |
DLL | Requires Msfpccom.dll. |
See Also
Send comments about this topic to Microsoft
Build date: 6/30/2010