Microsoft Internet Security and Acceleration Server 2004 SDK

IFPCIPsOnNetworks::Add[C++]

FPCIPsOnNetworks.Add [Visual Basic]

[C++]

The Add method creates a new FPCIPOnNetwork object in the collection and returns a reference to it.

HRESULT Add(
  BSTR NetworkName,
  FpcIPSelectionMethods IPSelectionMethod,
  BSTR IP,
  IFPCIPOnNetwork** ppNewIPOnNetwork
);

Parameters

NetworkName
[in] Required. BSTR that specifies the name of the network.
IPSelectionMethod
[in, optional] Value from the FpcIPSelectionMethods enumerated type that indicates whether all of the IP addresses on the ISA Server computers, only the default IP address, or only the IP address specified in the IP parameter, will be selected. The default value indicates that all of the IP addresses on the ISA Server computers are selected.
IP
[in, optional] BSTR that specifies the selected IP address. This parameter must be specified if the IPSelectionMethod parameter is set to fpcSpecifiedIPAddress, and it is ignored if the IPSelectionMethod parameter is not set or is set to any other value. The default value is an empty BSTR.
ppNewIPOnNetwork
[out] Address of an interface pointer that on return points to the new IFPCIPOnNetwork interface created.

Return Values

This method can return one of the following:

[Visual Basic]

The Add method creates a new FPCIPOnNetwork object in the collection and returns a reference to it.

Function Add( _
  ByVal NetworkName As String, _
  [ ByVal IPSelectionMethod As FpcIPSelectionMethods ], _
  [ ByVal IP As String ] _
) As FPCIPOnNetwork

Parameters

NetworkName
[in] Required. String that specifies the name of the network.
IPSelectionMethod
[in, optional] Value from the FpcIPSelectionMethods enumerated type that indicates whether all of the IP addresses on the ISA Server computers, only the default IP address, or only the IP address specified in the IP parameter, will be selected. The default value indicates that all of the IP addresses on the ISA Server computers are selected.
IP
[in, optional] String that specifies the selected IP address. This parameter must be specified if the IPSelectionMethod parameter is set to fpcSpecifiedIPAddress, and it is ignored if the IPSelectionMethod parameter is not set or is set to any other value. The default value is an empty string.

Return Values

This method returns a reference to an FPCIPOnNetwork object if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Requirements

Server: Requires Windows Server 2003 or Windows 2000.
Version: Requires Internet Security and Acceleration Server 2004.
Header: Declared in Msfpccom.idl.
Library: Use Microsoft Internet Security and Acceleration Server 2004 Administration Library.

See Also

FPCIPsOnNetworks