HostID Property of the IFPCEEServer Interface

Article
08/13/2010

The HostID property gets or sets the host ID of the server. The host ID uniquely identifies the server within its array.

C++

HRESULT put_HostID(
    long lHostID
);
HRESULT get_HostID(
    long* plHostID
);

Parameters

lHostID
A 32-bit integer that specifies the host ID of the server.
plHostID
Pointer to a variable that on return receives a 32-bit integer specifying the host ID of the server.

Return Value

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

Visual Basic

Property HostID As Long

Property Value

A 32-bit integer that specifies the host ID of the server.

Remarks

This property is read/write. It is initially set during setup, and its range of permissible values is from 2 through 32.

An array cannot contain more than 31 Forefront TMG computers. Each array member must have a unique host ID, which is assigned during installation. The host ID assigned to the first member of an array is 2. The host ID is used to identify the server for storage purposes, in VPN settings, and in Network Load Balancing configurations.

The value of this property should not be changed unless an alert is issued indicating that two or more array members have the same host ID. Such a conflict can occur if Forefront TMG is installed concurrently on multiple servers, if settings are not specified correctly in the .ini file for unattended Setup, and in some export and import scenarios.

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.

Share via