Share via

SetVIPAndMask Method of the IFPCEENLBCluster Interface

  • Article

The SetVIPAndMask method sets the virtual IP address and its mask for the Network Load Balancing (NLB) cluster.

C++

Syntax

HRESULT SetVIPAndMask(
  [in]  BSTR newIPAddress,
  [in]  BSTR newIPMask
);

Parameters

  • newIPAddress
    BSTR that specifies the virtual IP address for the NLB cluster in dotted-decimal format.
  • newIPMask
    BSTR that specifies the mask of the virtual IP address for the NLB cluster in dotted-decimal format.

Return Value

This method returns S_OK if the call is successful; otherwise, it returns an error code.

Visual Basic

Syntax

Sub SetVIPAndMask( _
  ByVal newIPAddress As String, _
  ByVal newIPMask As String _
)

Parameters

  • newIPAddress
    String that specifies the virtual IP address for the NLB cluster in dotted-decimal format.
  • newIPMask
    String that specifies the mask of the virtual IP address for the NLB cluster in dotted-decimal format.

Return Value

This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Remarks

This method sets the VIP and Mask properties and instructs NLB integration to set the virtual IP address specified as the second IP address of all the network adapters attached to the applicable network in the array.

The virtual IP address specified in newIPAddress must belong to the network.

The binary value of the subnet mask specified in newIPMask should consist of a series of ones followed by a series of zeros. These series of bits separate the IP address specified in newIPAddress into two parts. The first part specifies a network address, and the bits of the second part are reserved for all of the possible host addresses in the network segment. The combination of the virtual IP address and the subnet mask must specify the same network address as do the combinations of the dedicated IP addresses and subnet masks of the array member network adapters attached to the network.

The subnet mask typically consists of zero, one, two, or three binary octets that are represented in dotted-decimal format by the decimal number 255 and one binary octet that contains a series of ones (which may be empty) followed by a series of zeros and is represented by one of the following decimal numbers:

  • 254
  • 252
  • 248
  • 240
  • 224
  • 192
  • 128
  • 0

Note  All additional virtual IP addresses that are configured through the AdditionalVIPs property must be removed before changing the primary virtual IP address of an NLB cluster by calling this method or by programmatically importing the primary virtual IP address from a stored configuration.

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.

See Also

FPCNLBCluster

Send comments about this topic to Microsoft

Build date: 6/30/2010