hxpnets.h
上传用户:zhongxx05
上传日期:2007-06-06
资源大小:33641k
文件大小:6k
源码类别:

Symbian

开发平台:

C/C++

  1. /* ***** BEGIN LICENSE BLOCK ***** 
  2.  * Version: RCSL 1.0/RPSL 1.0 
  3.  *  
  4.  * Portions Copyright (c) 1995-2002 RealNetworks, Inc. All Rights Reserved. 
  5.  *      
  6.  * The contents of this file, and the files included with this file, are 
  7.  * subject to the current version of the RealNetworks Public Source License 
  8.  * Version 1.0 (the "RPSL") available at 
  9.  * http://www.helixcommunity.org/content/rpsl unless you have licensed 
  10.  * the file under the RealNetworks Community Source License Version 1.0 
  11.  * (the "RCSL") available at http://www.helixcommunity.org/content/rcsl, 
  12.  * in which case the RCSL will apply. You may also obtain the license terms 
  13.  * directly from RealNetworks.  You may not use this file except in 
  14.  * compliance with the RPSL or, if you have a valid RCSL with RealNetworks 
  15.  * applicable to this file, the RCSL.  Please see the applicable RPSL or 
  16.  * RCSL for the rights, obligations and limitations governing use of the 
  17.  * contents of the file.  
  18.  *  
  19.  * This file is part of the Helix DNA Technology. RealNetworks is the 
  20.  * developer of the Original Code and owns the copyrights in the portions 
  21.  * it created. 
  22.  *  
  23.  * This file, and the files included with this file, is distributed and made 
  24.  * available on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 
  25.  * EXPRESS OR IMPLIED, AND REALNETWORKS HEREBY DISCLAIMS ALL SUCH WARRANTIES, 
  26.  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, FITNESS 
  27.  * FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 
  28.  * 
  29.  * Technology Compatibility Kit Test Suite(s) Location: 
  30.  *    http://www.helixcommunity.org/content/tck 
  31.  * 
  32.  * Contributor(s): 
  33.  *  
  34.  * ***** END LICENSE BLOCK ***** */ 
  35. #ifndef _HXPNETS_H_
  36. #define _HXPNETS_H_
  37. /*
  38.  * Forward declarations of some interfaces used here-in.
  39.  */
  40. typedef _INTERFACE IHXTCPSocket IHXTCPSocket;
  41. typedef _INTERFACE IHXListenSocket IHXListenSocket;
  42. typedef _INTERFACE IHXHTTPProxy IHXHTTPProxy;
  43. typedef _INTERFACE IHXCloakedNetworkServices IHXCloakedNetworkServices;
  44. typedef _INTERFACE IHXValues       IHXValues;
  45. /****************************************************************************
  46.  * 
  47.  *  Interface:
  48.  * 
  49.  * IHXCloakedNetworkServices
  50.  * 
  51.  *  Purpose:
  52.  * 
  53.  * This is a factory interface for the various types of HTTP cloaked 
  54.  *      networking interfaces described above.
  55.  * 
  56.  *  IID_IHXCloakedNetworkServices:
  57.  *
  58.  *   {00000600-b4c8-11d0-9995-00a0248da5f0}
  59.  * 
  60.  */
  61. DEFINE_GUID(IID_IHXCloakedNetworkServices, 0x00000600, 0xb4c8, 0x11d0, 0x99, 
  62. 0x95, 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  63. #undef  INTERFACE
  64. #define INTERFACE   IHXCloakedNetworkServices
  65. DECLARE_INTERFACE_(IHXCloakedNetworkServices, IUnknown)
  66. {
  67.     /*
  68.      *  IUnknown methods
  69.      */
  70.     STDMETHOD(QueryInterface) (THIS_
  71. REFIID riid,
  72. void** ppvObj) PURE;
  73.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  74.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  75.     /*
  76.      * IHXNetworkCloakedServices methods
  77.      */
  78.     /************************************************************************
  79.      * Method:
  80.      *     IHXCloakedNetworkServices::CreateClientCloakedSocket
  81.      * Purpose:
  82.      *     Create a new HTTP cloaked TCP socket for the client.
  83.      */
  84.     STDMETHOD(CreateClientCloakedSocket) (THIS_
  85. IHXTCPSocket**    /*OUT*/     ppTCPSocket) PURE;
  86.     /************************************************************************
  87.      * Method:
  88.      *     IHXCloakedNetworkServices::CreateServerCloakedSocket
  89.      * Purpose:
  90.      *     Create a new HTTP cloaked TCP socket that will listen for 
  91.      *      connections on a particular port.
  92.      */
  93.     STDMETHOD(CreateServerCloakedSocket) (THIS_
  94. IHXListenSocket**    /*OUT*/     ppListenSocket) PURE;
  95. };
  96. /****************************************************************************
  97.  * 
  98.  *  Interface:
  99.  * 
  100.  * IHXHTTPProxy
  101.  * 
  102.  *  Purpose:
  103.  * 
  104.  * Provides the user with an asynchronous TCP networking interface.
  105.  * 
  106.  *  IID_IHXHTTPProxy:
  107.  * 
  108.  *   {00000601-b4c8-11d0-9995-00a0248da5f0}
  109.  *
  110.  */
  111. DEFINE_GUID(IID_IHXHTTPProxy, 0x00000601, 0xb4c8, 0x11d0, 0x99, 0x95, 
  112. 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  113. #undef  INTERFACE
  114. #define INTERFACE   IHXHTTPProxy
  115. DECLARE_INTERFACE_(IHXHTTPProxy, IUnknown)
  116. {
  117.     /*
  118.      *  IUnknown methods
  119.      */
  120.     STDMETHOD(QueryInterface) (THIS_
  121. REFIID riid,
  122. void** ppvObj) PURE;
  123.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  124.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  125.     /*
  126.      * IHXHTTPProxy methods
  127.      *
  128.      *  Network addresses and ports are in native byte order
  129.      *  
  130.      */
  131.     /************************************************************************
  132.      * Method:
  133.      *     IHXHTTPProxy::SetProxy
  134.      * Purpose:
  135.      *     This method is called when to set the HTTP proxy (if required)
  136.      *     while using HTTP cloaked socket behind the firewall. This 
  137.      *     interface is only supported by IHXTCPSocket returned by the 
  138.      *     CreateCloakedSocket.
  139.      */
  140.     STDMETHOD(SetProxy) (THIS_
  141. const char* /*IN*/  pProxyHostName,
  142. UINT16     /*IN*/  nPort) PURE;
  143. };
  144. /****************************************************************************
  145.  * 
  146.  *  Interface:
  147.  * 
  148.  * IHXCloakedTCPSocket
  149.  * 
  150.  *  Purpose:
  151.  * 
  152.  * interfaces specific to cloaked TCP sockets
  153.  * 
  154.  *  IID_IHXCloakedTCPSocket:
  155.  * 
  156.  *   {00000602-b4c8-11d0-9995-00a0248da5f0}
  157.  *
  158.  */
  159. DEFINE_GUID(IID_IHXCloakedTCPSocket, 0x00000602, 0xb4c8, 0x11d0, 0x99, 0x95, 
  160. 0x0, 0xa0, 0x24, 0x8d, 0xa5, 0xf0);
  161. #undef  INTERFACE
  162. #define INTERFACE   IHXCloakedTCPSocket
  163. DECLARE_INTERFACE_(IHXCloakedTCPSocket, IUnknown)
  164. {
  165.     /*
  166.      *  IUnknown methods
  167.      */
  168.     STDMETHOD(QueryInterface) (THIS_
  169. REFIID riid,
  170. void** ppvObj) PURE;
  171.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  172.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  173.     /*
  174.      * IHXCloakedTCPSocket methods
  175.      *
  176.      */
  177.     /************************************************************************
  178.      * Method:
  179.      *     IHXCloakedTCPSocket::InitCloak
  180.      */
  181.     STDMETHOD(InitCloak) (THIS_
  182. IHXValues* /*IN*/  pValues,
  183. IUnknown* pUnknown) PURE;
  184. };
  185. #endif /* _HXPNETS_H_ */