Connect Method of the IFPCArrays Interface

  • Article

The Connect method connects to the specified ISA Server computer, adds the FPCArray object for the specified server to the collection, and returns a reference to the array object.

C++

Syntax

HRESULT Connect(
  [in]            BSTR Server,
  [in, optional]  BSTR UserName,
  [in, optional]  BSTR Domain,
  [in, optional]  BSTR Password,
  [out]           IFPCArray** ppArray
);

Parameters

  • Server
    BSTR that specifies the ISA Server computer to which to connect.

  • UserName
    BSTR that specifies the user name. The default value is an empty BSTR.

  • Domain
    BSTR that specifies the name of the user's domain. The default value is an empty BSTR.

  • Password
    BSTR that specifies the password. The default value is an empty BSTR.

  • ppArray
    Address of an interface pointer that on return points to an IFPCArray interface that represents the containing array of the specified server.

Return Value

This method can return one of the following:

  • S_OK, indicating that the operation succeeded.
  • An error code, indicating that the operation failed. In this case, the [out] parameter returned is a null object.

Visual Basic

Syntax

Function Connect( _
  ByVal Server As String, _
  [ ByVal UserName As String ], _
  [ ByVal Domain As String ], _
  [ ByVal Password As String ] _
) As FPCArray

Parameters

  • Server
    String that specifies the ISA Server computer to which to connect.
  • UserName
    String that specifies the user name. The default value is an empty string.
  • Domain
    String that specifies the name of the user's domain. The default value is an empty string.
  • Password
    String that specifies the password. The default value is an empty string.

Return Value

This method returns a reference to the FPCArray object for the ISA Server computer specified if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

This method is deprecated in Forefront TMG. Call the ConnectToConfigurationStorageServer or ConnectToConfigServerPort method on the root (FPC) object to connect to a specified Configuration Storage server from a remote management computer. Every Forefront TMG computer with the Microsoft Firewall service installed is also a Configuration Storage server.

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

FPCArrays

Send comments about this topic to Microsoft

Build date: 6/30/2010