The SetVIPAndMask method sets the virtual IP address and its mask for the Network Load Balancing (NLB) cluster.
HRESULT SetVIPAndMask( [in] BSTR newIPAddress, [in] BSTR newIPMask );
This method returns S_OK if the call is successful; otherwise, it returns an error code.
Sub SetVIPAndMask( _ ByVal newIPAddress As String, _ ByVal newIPMask As String _ )
This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.
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:
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.
|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.