TestConnectivity Method of the IFPCWebPublishingProperties4 Interface

  • Article

The TestConnectivity method performs tests to verify connectivity with the published Web server using the configuration settings defined in the Web publishing rule.

C++

Syntax

HRESULT TestConnectivity(
  [out]  BSTR* pbstrTestResult
);

Parameters

  • pbstrTestResult
    Pointer to a BSTR that is set on return to a string value specifying the results of the connectivity tests.

Return Value

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

Visual Basic

Syntax

Function TestConnectivity() As String

Parameters

This method has no parameters.

Return Value

This method returns a string value that specifies the results of the connectivity tests if successful. Otherwise, an error is raised that can be intercepted by using an error handler.

Remarks

When this method is called, Forefront TMG first attempts to resolve the name specified in the WebSite or PublishedServer property. After the name is resolved to an IP address, Forefront TMG tries to establish a TCP/IP connection with the published Web server. For a publishing rule that requires an SSL connection with the published server, an attempt is made to establish such a connection and to test the certificate for validity according to the configuration settings defined in the rule. Forefront TMG also sends an HTTP GET request to the published server and waits for a response. If a response is received, Forefront TMG compares its authentication requirements and methods to the requirements specified in the configuration settings of the rule.

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

FPCWebPublishingProperties

Send comments about this topic to Microsoft

Build date: 6/30/2010