IFPCWebProxy::CARPNameSystem property

Article
08/27/2012

Applies to: desktop apps only

The CARPNameSystem property gets or sets a value from the FpcNameSystem enumerated type that specifies the method to be used by Web browsers for resolving the names of array members to which they are to connect according to the Cache Array Routing Protocol (CARP) algorithm. Based on the value of this property, Forefront TMG provides a script to Web browsers that uses the CARP algorithm to generate prioritized lists of array members that are identified by their fully qualified domain names (FQDN) for resolution using the DNS name lookup system, by their NetBIOS names for resolution using the WINS name lookup system, or by their IP addresses.

Note This property is applicable only to Forefront TMG Enterprise Edition.

This property is read/write.

Syntax

HRESULT put_CARPNameSystem(
  FpcNameSystem NameSystem
);

HRESULT get_CARPNameSystem(
  FpcNameSystem *pNameSystem
);

' Data type: FpcNameSystem

Property CARPNameSystem( _
  ByVal NameSystem As FpcNameSystem, _
  ByVal pNameSystem As FpcNameSystem _
) As FpcNameSystem

Property value

Value from the FpcNameSystem enumerated type that specifies the method to be used by Web browsers for resolving the name of array members to which they are to connect according to the CARP algorithm.

Error codes

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 fpcNameSystem_DNS, which indicates that Web browsers will use the DNS name lookup system.

Setting this property correctly is important because some computers do not have WINS names and will not work in CARP unless DNS name lookup is required or the IP addresses are provided in the script.

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.

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll

Share via