DNSName Property of the IFPCEEArray Interface

The DNSName property gets or sets the DNS name of the array.

[C++]

HRESULT put_DNSName(
	BSTR bstrDNSName
);
HRESULT get_DNSName(
	BSTR* pbstrDNSName
);

Parameters

pbstrDNSName: Pointer to a BSTR that is set on return to a string value specifying the DNS name of the array.
bstrDNSName: BSTR that specifies the DNS name of the array.

Return Value

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

[Visual Basic]

Property DNSName As String

Property Value

String that specifies the DNS name of the array.

Remarks

This property is read/write. Its default value is an empty string.

The DNS name of an array can be used in the settings that are passed to Firewall clients and Web browsers running on Firewall clients so that they can send requests to the array as a single logical unit. The DNS name of the array should then be mapped in the DNS zone files used by the clients to the IP addresses of the array members.

If CARP is enabled for the array, Web proxy clients (CERN-compatible applications, such as Web browsers, running on a Firewall client or on a SecureNAT client) can use the DNS name of the array to connect to an array member and download a script that implements the CARP algorithm. The clients then use the script to obtain a prioritized list of array members that can serve specific Web content.

For Network Load Balancing, the DNS name of the array should be mapped in the DNS zone files used by clients to the virtual IP addresses (VIP) of all the Network Load Balancing clusters that are configured in the array followed by the default IP addresses of the array members. When a Network Load Balancing cluster is enabled, clients in the applicable network that send requests to the DNS name of the array would use its virtual IP address because it is the first available IP address to which the DNS name is resolved. When the cluster is disabled, clients would use the first available dedicated IP address.

The DNS name of an array can also be used to configure firewall chaining (FPCFirewallChaining objects) and Web chaining rules (FPCRoutingRule objects) to an upstream Forefront TMG array.

Requirements

Client	Requires Windows Vista or Windows XP.
Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.