CAsyncProxySocket - CAsyncSocket derived class to connect through proxies






4.73/5 (11 votes)
Dec 9, 2001
2 min read

292788

7689
This class allows you to establish connections through SOCKS4/5 and HTTP 1.1 proxies.
Introduction
This class is a CAsyncSocket
derived class. With this class, you can connect through SOCKS4/5 and HTTP 1.1 proxies. This class works as semi-transparent layer between your own class and CAsyncSocket
. This class is used in FileZilla, a powerful open-source FTP client. It can be found here. For more information about SOCKS4/5, go here. For more information about HTTP 1.1, go here and search for RFC2616 and RFC2617.
How to use?
If you are usingCAsyncSocket
, you don't have to change much in your already existing code to use CAsyncProxySocket
. To use it, you've to derive your own class from CAsyncProxySocket
instead from CAsyncSocket
, and you've to provide a definition for OnProxyOperationFailed(int nOpID)
and OnListenFinished(unsigned long &retProxyIp,int &retProxyPort)
. When you create an instance of your derived class, you should call SetProxy
. If you overload the OnReceive
or OnConnect
functions in your derived class, you have to call CAsyncProxySocket::OnReceive
and CAsyncProxySocket::OnConnect
as first instruction in your OnReceive
and OnConnect
functions.
Sample code:
CMyClass::OnReceive(int nErrorCode) { CAsyncProxySocket::OnReceive(nErrorCode); //Add you own implementation below: ... }
If an operation fails, OnProxyOperationFailed
is called. There you can handle the error. int nOpID
specifies the type of the operation that failed: PROXYOP_CONNECT
when a connection attempt failed and PROXYOP_LISTEN
when creating a listen socket failed.
If you want to use CAsyncProxySocket
to create a listen socket, you have to use this overloaded function: virtual BOOL Listen(unsigned long serverIp)
. serverIP
is the IP of the server you are already connected through the SOCKS proxy. You can't use listen sockets over a SOCKS proxy without a primary connection. Listen sockets are only supported by SOCKS proxies, this won't work with HTTP proxies. When the listen socket is created successfully, OnListenFinished
is called. The parameters unsigned long &retProxyIp
and int &retProxyPort
will tell you the IP and the port of the listen socket. After that, you have to handle the OnAccept
message and accept the connection.
Description of the other new functions and their parameters
void SetProxy(int nProxyType); void SetProxy(int nProxyType, CString ProxyHost, int nProxyPort); void SetProxy(int nProxyType, CString ProxyHost, int nProxyPort,CString ProxyUser, CString ProxyPass);
Call one of these functions to set the proxy type. Parameters:
nProxyType
specifies the Proxy Type.ProxyHost
andnProxyPort
specify the address of the proxy.ProxyUser
andProxyPass
are only available for SOCKS5 proxies.
Supported proxy types:
PROXYTYPE_NOPROXY
PROXYTYPE_SOCKS4
PROXYTYPE_SOCKS4A
PROXYTYPE_SOCKS5
PROXYTYPE_HTTP11
GetProxyPeerName
GetProxyPeerName
is like GetPeerName
of CAsyncSocket
, but returns the address of the server connected through the proxy. If using proxies, GetPeerName
only returns the address of the proxy.
int GetProxyType()
Returns the used proxy type.
const int GetLastProxyError() const;
Returns the last proxy error.
History
- 20 Dec 2001
- Added basic HTTP 1.1 authentication.
- Fixed memory leak in SOCKS5 code.
OnSocksOperationFailed
will be called after Socket has been closed.- Fixed some minor bugs.
- 9 Dec 2001
- Initial release.