Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
DNSName Property

DNSName Property of IFPCEEArray[C++] | FPCArray.DNSName [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

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


HRESULT get_DNSName(
  BSTR* pbstrDNSName );

HRESULT put_DNSName(
  BSTR bstrDNSName );

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 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 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 ISA Server array.

This property is available only in ISA Server Enterprise Edition.

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


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 ISA Server array.

This property is available only in ISA Server Enterprise Edition.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003.
Version Requires Internet Security and Acceleration (ISA) Server 2006 Enterprise Edition or ISA Server 2004 Enterprise Edition.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCArray

Show:
© 2015 Microsoft