Share via

ConnectToConfigServerPort Method of the IFPC2 Interface

  • Article

The ConnectToConfigServerPort method connects to the specified Configuration Storage server on a specific port.

C++

Syntax

HRESULT ConnectToConfigServerPort(
  [in, optional]  BSTR ConfigurationStorageServer,
  [in, optional]  BSTR StorageUserName,
  [in, optional]  BSTR StorageUserDomain,
  [in, optional]  BSTR StorageUserPassword,
  [in, optional]  BSTR MonitoringUserName,
  [in, optional]  BSTR MonitoringUserDomain,
  [in, optional]  BSTR MonitoringUserPassword,
  [in, optional]  FpcStorageServerConnectionType eConnectionType,
  [in, optional]  long Port
);

Parameters

  • ConfigurationStorageServer
    BSTR that specifies the name of the Configuration Storage server. The default value is an empty BSTR, which indicates the local computer.

  • StorageUserName
    BSTR that specifies the name of a user with the permissions needed to modify the stored enterprise configuration. The default value is an empty BSTR, which specifies the user who is currently logged on.

  • StorageUserDomain
    BSTR that specifies the name of the domain of the user with the permissions needed to modify the stored enterprise configuration. The default value is an empty BSTR, which specifies the domain of the user who is currently logged on.

  • StorageUserPassword
    BSTR that specifies the password of the user with the permissions needed to modify the stored enterprise configuration. The default value is an empty BSTR, which specifies the password provided by the user who is currently logged on.

  • MonitoringUserName
    BSTR that specifies the name of a user with the permissions needed to read the stored enterprise configuration. The default value is an empty BSTR, which specifies the user who is currently logged on.

  • MonitoringUserDomain
    BSTR that specifies the name of the domain of the user with the permissions needed to read the stored enterprise configuration. The default value is an empty BSTR, which specifies the domain of the user who is currently logged on.

  • MonitoringUserPassword
    BSTR that specifies the password of the user with the permissions needed to read the stored enterprise configuration. The default value is an empty BSTR, which specifies the password provided by the user who is currently logged on.

  • eConnectionType
    Value from the FpcStorageServerConnectionType enumerated type that specifies whether the connection between the array member or remote management computer and the Configuration Storage server will be over an unencrypted channel or over a Secure Sockets Layer (SSL) channel. The default value is fpcRegularStorageConnection, which specifies that the connection will be over an unencrypted channel.

  • Port
    A 32-bit integer that specifies the port on which the local computer will communicate with the Configuration Storage server.

Return Value

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

Visual Basic

Syntax

Sub ConnectToConfigServerPort( _
  [ ByVal ConfigurationStorageServer As String ], _
  [ ByVal StorageUserName As String ], _
  [ ByVal StorageUserDomain As String ], _
  [ ByVal StorageUserPassword As String ], _
  [ ByVal MonitoringUserName As String ], _
  [ ByVal MonitoringUserDomain As String ], _
  [ ByVal MonitoringUserPassword As String ], _
  [ ByVal eConnectionType As FpcStorageServerConnectionType ], _
  [ ByVal Port As Long ] _
)

Parameters

  • ConfigurationStorageServer
    String value that specifies the name of the Configuration Storage server. The default value is an empty string, which indicates the local computer.

  • StorageUserName
    String value that specifies the name of a user with the permissions needed to modify the stored enterprise configuration. The default value is an empty string, which specifies the user who is currently logged on.

  • StorageUserDomain
    String value that specifies the name of the domain of the user with the permissions needed to modify the stored enterprise configuration. The default value is an empty string, which specifies the domain of the user who is currently logged on.

  • StorageUserPassword
    String value that specifies the password of the user with the permissions needed to modify the stored enterprise configuration. The default value is an empty string, which specifies the password provided by the user who is currently logged on.

  • MonitoringUserName
    String value that specifies the name of a user with the permissions needed to read the stored enterprise configuration. The default value is an empty string, which specifies the user who is currently logged on.

  • MonitoringUserDomain
    String value that specifies the name of the domain of the user with the permissions needed to read the stored enterprise configuration. The default value is an empty string, which specifies the domain of the user who is currently logged on.

  • MonitoringUserPassword
    String value that specifies the password of the user with the permissions needed to read the stored enterprise configuration. The default value is an empty string, which specifies the password provided by the user who is currently logged on.

  • eConnectionType
    Value from the FpcStorageServerConnectionType enumerated type that specifies whether the connection between the array member or remote management computer and the Configuration Storage server will be over an unencrypted channel or over a Secure Sockets Layer (SSL) channel. The default value is fpcRegularStorageConnection, which specifies that the connection will be over an unencrypted channel.

  • Port
    A 32-bit integer that specifies the port on which the local computer will communicate with the Configuration Storage server.

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

If user credentials are not supplied, the credentials of the user who is currently logged on are used.

When an FPC root object is created on an array member, it automatically attempts to connect to the Configuration Storage server specified in the registry for the array using the credentials of the user who is currently logged on. If this user is not an enterprise administrator or an enterprise auditor, the ConnectToConfigServerPort or ConnectToConfigurationStorageServer method must be called to connect to a Configuration Storage server.

After a connection to a Configuration Storage server is established and configuration changes are made, you should not call the DisconnectFromConfigurationStorageServer method and then the ConnectToConfigServerPort or ConnectToConfigurationStorageServer method to establish a new connection before saving the changes made using the current connection.

A computer on which Forefront TMG Management is installed without the Microsoft Firewall service can serve as a remote management computer and can create an instance of the root (FPC) object. However, that computer cannot access the properties of the root object or any other object in the administration COM object hierarchy until it connects to a Configuration Storage server using this method or the ConnectToConfigurationStorageServer method.

The following types of Forefront TMG computers are Configuration Storage servers, and the ConnectToConfigServerPort method can be used to connect to them from a remote management computer.

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

FPC

Send comments about this topic to Microsoft

Build date: 6/30/2010