The SetProxyServerInfo function stores proxy server information inside the currently loaded license.  

Syntax

HRESULT SetProxyServerInfo( VARIANT_BOOL UseProxyServer, BSTR ProxyServerName, long ProxyPort, VARIANT_BOOL UseProxyAuthentication, BSTR ProxyUserName, BSTR ProxyPassword, VARIANT_BOOL * Success ) ;

Parameters

UseProxyServer

[IN] This is a boolean value that you must set to true if the ClientProtector should use the proxy server information in communicating with the CheckPoint server, false otherwise.

 

ProxyServerName

[IN] This is a string value that you must set to the proxy server name (or IP) that the ClientProtector should use to locate the proxy server when performing CheckPoint communication.  This value is ignored by the ClientProtector if UseProxyServer is false.

 

ProxyPort

[IN] This is a numeric value that you must set to the proxy server port number (usually 8080 but can be anything) that the ClientProtector should use to invoke the proxy server when performing CheckPoint communication.  This value is ignored by the ClientProtector if UseProxyServer is false.

 

UseProxyAuthentication

[IN] This is a boolean value that you must set to true if the proxy server uses authentication (only "Basic Authentication" is supported).  This value is ignored by the ClientProtector if UseProxyServer is false.

 

ProxyUserName

[IN] This is a string value that you must set to the users proxy server account name (used for authentication).  This value is ignored by the ClientProtector if UseProxyServer or UseProxyAuthentication is false.

 

ProxyPassword

[IN] This is a string value that you must set to the users proxy server password (used for authentication).  This value is ignored by the ClientProtector if UseProxyServer or UseProxyAuthentication is false.

 

Success

[OUT] This is (a pointer to) a boolean value that returns true if the proxy server information was successfully set, false otherwise.  This will return false if the license was not correctly initialized with a call to StartUp.

Remarks

The SetProxyServerInfo function sets proxy server information stored inside the currently loaded license (if any).  This information is used during any web-service communication the ClientProtector will make with your CheckPoint server (as identified by the CheckPoint Server URL).

Note that this information is only relevant to the client machine on which it runs.  You may subsequently retrieve this information at any time using GetProxyServerInfo.

Before setting these values gathered from the user, you may wish to walk the user through a test connection to ensure they were entered correctly.  To do this, use QuickTestCheckPointConnection.

About SSL (HTTPS) and Proxy Servers

Keep in mind that proxy servers generally can not act as a proxy for HTTPS (SSL) communication.  HTTPS requires a secure handshake from point-to-point to enable its secure communications.  A proxy server can not be in between the two participants (client and server) of an SSL communication. Most enterprises that use proxy servers allow direct outbound SSL communication for the workstations (default port 443) to allow SSL communication to work.  If you are deploying your CheckPoint Server to be accessible via HTTPS only, be sure to take this into account when managing proxy server information.

Return Value

As with all COM function calls they return an HRESULT. HRESULT is a data type that is a 32-bit error or warning code. Check your compilers documentation for information on interpreting the HRESULT value.

Function Information

Exposed By Interface:	"ISSCProtector"
Exposed In COM Server Binaries:	"SSCProt.dll" and "SSCProtD.dll"