hxpnets.h
上传用户:dangjiwu
上传日期:2013-07-19
资源大小:42019k
文件大小:7k
源码类别:

Symbian

开发平台:

Visual C++

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