IServerClient::TestConnection method

Makes a test connection to the IM server using the given address and TCP/IP port. This function can be used for verification purposes to check a presence of the IM server. The function does not establish a session with the IM server, it disconnects once the IM server accepts a connection.

HRESULT TestConnection(     LPSTR lpszServerAddress,     WORD wServerPort, );

Parameters

lpszServerAddress
[in] Pointer to a null-terminated text buffer that contains the name or address of the IM server. The address can be IP address or DNS name of a computer. Size of the buffer must not exceed 255 symbols of length.
wServerPort
[in] WORD variable that specifies TCP/IP port on the IM server to connect to. Set this parameter to 0 value to use default port.

Return Value

S_OK
Connection to the IM server is successful.
E_FAIL
Cannot connect to the IM server because it is not found or not running. Check the server address and port.