Connect Method of the IFPCArrays Interface

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:

[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 Vista or Windows XP.
Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).
IDL

Declared in Msfpccom.idl.

DLL

Requires Msfpccom.dll.

See Also

FPCArrays


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.