Export (0) Print
Expand All

IFPCConnectivityVerifier::SetConnectivityRequest[C++] | FPCConnectivityVerifier.SetConnectivityRequest [Visual Basic]

Internet Security and Acceleration Server 2004/2006 SDK

The SetConnectivityRequest method sets the ServerAddress, RequestType, and TCPPort properties of the connectivity verifier object.


HRESULT SetConnectivityRequest(
  BSTR ServerAddress,
  FpcRequestType RequestType,
  long TCPPort );

Parameters

ServerAddress
[in] String value that specifies the address of the server to which connectivity is to be verified.
RequestType
[in] Value from the FpcRequestType enumerated type that specifies the type of request to be used in the verification operation of the connectivity verifier.
TCPPort
[in, optional] A 32-bit integer that specifies the TCP port on the remote server to which connectivity is to be verified. This parameter should be set only if the RequestType parameter is set to fpcTcpConnect.

Return Values

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

Remarks

If the value of the RequestType parameter is set to fpcHttpConnect, a system policy rule, named Allow HTTP/HTTPS requests from ISA Server to selected servers for connectivity verifiers, which belongs to the HTTP Connectivity Verifiers configuration group, must be enabled for the connectivity verifier to work. For information about how to enable a system policy rule by enabling its configuration group, see the Enabled property of the FPCSystemPolicyConfigGroup object.

The SetConnectivityRequest method sets the ServerAddress, RequestType, and TCPPort properties of the connectivity verifier object.


Sub SetConnectivityRequest( _
  ByVal ServerAddress As String, _
  ByVal RequestType As FpcRequestType, _
  [ ByVal TCPPort As Long ] _
)

Parameters

ServerAddress
[in] String value that specifies the address of the server to which connectivity is to be verified.
RequestType
[in] Value from the FpcRequestType enumerated type that specifies the type of request to be used in the verification operation of the connectivity verifier.
TCPPort
[in, optional] A 32-bit integer that specifies the TCP port on the remote server to which connectivity is to be verified. This parameter should be set only if the RequestType parameter is set to fpcTcpConnect.

Return Values

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 the value of the RequestType parameter is set to fpcHttpConnect, a system policy rule, named Allow HTTP/HTTPS requests from ISA Server to selected servers for connectivity verifiers, which belongs to the HTTP Connectivity Verifiers configuration group, must be enabled for the connectivity verifier to work. For information about how to enable a system policy rule by enabling its configuration group, see the Enabled property of the FPCSystemPolicyConfigGroup object.

Example Code

For a VBScript code example that shows how to use this method to set the request type of a new connectivity verifier, see Adding a Connectivity Verifier.

Requirements

Client Requires Windows XP.
Server Requires Windows Server 2003. Requires Windows Server 2003 or Windows 2000 for ISA Server 2004 Standard Edition.
Version Requires Internet Security and Acceleration (ISA) Server 2006 or ISA Server 2004.
IDL

Declared in Msfpccom.idl.

DLL Requires Msfpccom.dll.

See Also

FPCConnectivityVerifier

Show:
© 2014 Microsoft