The DNSName property gets or sets the DNS name of the array.
HRESULT put_DNSName( BSTR bstrDNSName ); HRESULT get_DNSName( BSTR* pbstrDNSName );
Pointer to a BSTR that is set on return to a string value specifying the DNS name of the array.
BSTR that specifies the DNS name of the array.
These property methods return S_OK if the call is successful; otherwise, they return an error code.
Property DNSName As String
String that specifies the DNS name of the array.
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.
|Client||Requires Windows Vista or Windows XP.|
|Server||Requires Windows Server 2008.|
|Version||Requires Forefront Threat Management Gateway (TMG).|
Declared in Msfpccom.idl.
Build date: 11/30/2009
© 2008 Microsoft Corporation. All rights reserved.