开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > Symbian > 查看源码
hxfiles.h
资源名称：142_61_thumb_advanced.rar　[点击查看]
上传用户：dangjiwu
上传日期：2013-07-19
资源大小：42019k
文件大小：70k
源码类别：

Symbian

开发平台：

Visual C++

hxfiles.h：源码内容
  1. /* ***** BEGIN LICENSE BLOCK *****
  2.  * Source last modified: $Id: hxfiles.h,v 1.4.8.4 2004/07/09 01:45:08 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 ***** */
  50. #ifndef _HXFILES_H_
  51. #define _HXFILES_H_
  53. /*
  54.  * Forward declarations of some interfaces defined here-in.
  55.  */
  56. typedef _INTERFACE IHXFileObject IHXFileObject;
  57. typedef _INTERFACE IHXFileObjectExt IHXFileObjectExt;
  58. typedef _INTERFACE IHXFileResponse IHXFileResponse;
  59. typedef _INTERFACE IHXFileSystemObject IHXFileSystemObject;
  60. typedef _INTERFACE IHXFileStat IHXFileStat;
  61. typedef _INTERFACE IHXFileStatResponse IHXFileStatResponse;
  63. typedef _INTERFACE IHXFileSystemManager IHXFileSystemManager;
  64. typedef _INTERFACE IHXFileSystemManagerResponse IHXFileSystemManagerResponse;
  65. typedef _INTERFACE IHXFileExists IHXFileExists;
  66. typedef _INTERFACE IHXFileExistsResponse IHXFileExistsResponse;
  67. typedef _INTERFACE IHXFileMimeMapper IHXFileMimeMapper;
  68. typedef _INTERFACE IHXFileMimeMapperResponse IHXFileMimeMapperResponse;
  69. typedef _INTERFACE IHXBroadcastMapper IHXBroadcastMapper;
  70. typedef _INTERFACE IHXBroadcastMapperResponse IHXBroadcastMapperResponse;
  71. typedef _INTERFACE IHXGetFileFromSamePoolResponse IHXGetFileFromSamePoolResponse;
  72. typedef _INTERFACE IHXBuffer IHXBuffer;
  73. typedef _INTERFACE IHXPacket IHXPacket;
  74. typedef _INTERFACE IHXValues IHXValues;
  75. typedef _INTERFACE IHXMetaCreation IHXMetaCreation;
  77. typedef _INTERFACE IHXAuthenticator               IHXAuthenticator;
  78. typedef _INTERFACE IHXRequest                     IHXRequest;
  79. typedef _INTERFACE IHXFileRename                  IHXFileRename;
  80. typedef _INTERFACE IHXFileMove IHXFileMove;
  81. typedef _INTERFACE IHXDirHandler IHXDirHandler;
  82. typedef _INTERFACE IHXDirHandlerResponse IHXDirHandlerResponse;
  83. typedef _INTERFACE IHXFileRemove                  IHXFileRemove;
  84. // $Private:
  85. typedef _INTERFACE IHXFastFileFactory             IHXFastFileFactory;
  86. typedef _INTERFACE IHXHTTPPostObject IHXHTTPPostObject;
  87. typedef _INTERFACE IHXHTTPPostResponse IHXHTTPPostResponse;
  88. typedef _INTERFACE IHXHTTPRedirect IHXHTTPRedirect;
  89. typedef _INTERFACE IHXHTTPRedirectResponse IHXHTTPRedirectResponse;
  90. typedef _INTERFACE IHXRM2Converter2               IHXRM2Converter2;
  91. typedef _INTERFACE IHXRM2Converter2Response       IHXRM2Converter2Response;
  92. typedef _INTERFACE IHXPoolPathAdjustment IHXPoolPathAdjustment;
  93. typedef _INTERFACE IHXPostDataHandler IHXPostDataHandler;
  94. // $EndPrivate.
  97. /****************************************************************************
  98.  *  Defines:
  99.  * HX_FILE_XXXX
  100.  *  Purpose:
  101.  * Flags for opening file objects
  102.  */
  103. #define HX_FILE_READ 1
  104. #define HX_FILE_WRITE 2
  105. #define HX_FILE_BINARY 4
  106. #define HX_FILE_NOTRUNC 8
  107. #define HX_FILE_NOPAC 16
  109. /****************************************************************************
  110.  *  Defines:
  111.  * HX_FILEADVISE_XXXX
  112.  *  Purpose:
  113.  * Flags for file object Advise method
  114.  */
  115. #define HX_FILEADVISE_RANDOMACCESS 1
  116. #define HX_FILEADVISE_SYNCACCESS 2
  117. #define HX_FILEADVISE_ASYNCACCESS 3
  118. #define HX_FILEADVISE_RANDOMACCESSONLY  4
  119. #define HX_FILEADVISE_ANYACCESS         5
  121. /****************************************************************************
  122.  *  Defines:
  123.  * HX_FILERESPONSEADVISE_XXXX
  124.  *  Purpose:
  125.  * Flags for file response Advise method
  126.  */
  127. #define HX_FILERESPONSEADVISE_REQUIREFULLREAD 1
  130. #if defined(_UNIX) || defined(_WINDOWS)
  131. #include "hlxclib/sys/stat.h"
  132. /*
  133.  * This is a subset of standard stat()/fstat() values that both Unix and
  134.  * Windows support (or at least define).
  135.  *
  136.  * These flags are returned from IHXFileStatResponse::StatDone() in the
  137.  * ulMode argument.
  138.  */
  139. #define HX_S_IFMT   S_IFMT
  140. #define HX_S_IFDIR  S_IFDIR
  141. #define HX_S_IFCHR  S_IFCHR
  142. #define HX_S_IFIFO  S_IFIFO
  143. #define HX_S_IFREG  S_IFREG
  144. #else
  145. /* Macintosh */
  146. #define HX_S_IFMT   0170000
  147. #define HX_S_IFDIR  0040000
  148. #define HX_S_IFCHR  0020000
  149. #define HX_S_IFIFO  0010000
  150. #define HX_S_IFREG  0100000
  151. #endif
  154. /****************************************************************************
  155.  * 
  156.  *  Interface:
  157.  * 
  158.  * IHXFileObject
  159.  * 
  160.  *  Purpose:
  161.  * 
  162.  * Object that exports file control API
  163.  * 
  164.  *  IID_IHXFileObject:
  165.  * 
  166.  * {00000200-0901-11d1-8B06-00A024406D59}
  167.  * 
  168.  */
  169. DEFINE_GUID(IID_IHXFileObject, 0x00000200, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  170. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  172. #undef  INTERFACE
  173. #define INTERFACE   IHXFileObject
  175. DECLARE_INTERFACE_(IHXFileObject, IUnknown)
  176. {
  177.     /*
  178.      * IUnknown methods
  179.      */
  180.     STDMETHOD(QueryInterface) (THIS_
  181. REFIID riid,
  182. void** ppvObj) PURE;
  184.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  186.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  188.     /*
  189.      * IHXFileObject methods
  190.      */
  192.     /************************************************************************
  193.      * Method:
  194.      *     IHXFileObject::Init
  195.      * Purpose:
  196.      *     Associates a file object with the file response object it should
  197.      *     notify of operation completness. This method should also check
  198.      *     for validity of the object (for example by opening it if it is
  199.      *     a local file).
  200.      */
  201.     STDMETHOD(Init) (THIS_
  202. ULONG32     /*IN*/  ulFlags,
  203. IHXFileResponse*   /*IN*/  pFileResponse) PURE;
  205.     /************************************************************************
  206.      * Method:
  207.      *     IHXFileObject::GetFilename
  208.      * Purpose:
  209.      *     Returns the filename (without any path information) associated
  210.      *     with a file object.
  211.      *
  212.      *     Note: The returned pointer's lifetime expires as soon as the
  213.      *     caller returns from a function which was called from the RMA
  214.      *     core (i.e. when you return control to the RMA core)
  215.      *
  216.      */
  217.     STDMETHOD(GetFilename) (THIS_
  218. REF(const char*)    /*OUT*/  pFilename) PURE;
  220.     /************************************************************************
  221.      * Method:
  222.      *     IHXFileObject::Close
  223.      * Purpose:
  224.      *     Closes the file resource and releases all resources associated
  225.      *     with the object.
  226.      */
  227.     STDMETHOD(Close) (THIS) PURE;
  229.     /************************************************************************
  230.      * Method:
  231.      *     IHXFileObject::Read
  232.      * Purpose:
  233.      *     Reads a buffer of data of the specified length from the file
  234.      *     and asynchronously returns it to the caller via the 
  235.      *     IHXFileResponse interface passed in to Init.
  236.      */
  237.     STDMETHOD(Read) (THIS_
  238. ULONG32 ulCount) PURE;
  240.     /************************************************************************
  241.      * Method:
  242.      *     IHXFileObject::Write
  243.      * Purpose:
  244.      *     Writes a buffer of data to the file and asynchronously notifies
  245.      *     the caller via the IHXFileResponse interface passed in to Init,
  246.      *     of the completeness of the operation.
  247.      */
  248.     STDMETHOD(Write) (THIS_
  249. IHXBuffer* pBuffer) PURE;
  251.     /************************************************************************
  252.      * Method:
  253.      *     IHXFileObject::Seek
  254.      * Purpose:
  255.      *     Seeks to an offset in the file and asynchronously notifies
  256.      *     the caller via the IHXFileResponse interface passed in to Init,
  257.      *     of the completeness of the operation.
  258.      *     If the bRelative flag is TRUE, it is a relative seek; else
  259.      *     an absolute seek.
  260.      */
  261.     STDMETHOD(Seek) (THIS_
  262. ULONG32 ulOffset,
  263. BOOL bRelative) PURE;    
  265.     /************************************************************************
  266.      * Method:
  267.      *     IHXFileObject::Advise
  268.      * Purpose:
  269.      *      To pass information to the File Object advising it about usage
  270.      *     heuristics.
  271.      */
  272.     STDMETHOD(Advise) (THIS_
  273. ULONG32 ulInfo) PURE;
  274. };
  277. /****************************************************************************
  278.  *
  279.  *  Interface:
  280.  *
  281.  *  IHXFileObjectExt
  282.  *
  283.  *  Purpose:
  284.  *
  285.  *  Object that exports file control API
  286.  *
  287.  *  IID_IHXFileObjectExt:
  288.  *
  289.  *  {96DD5EB5-7EFD-4084-95CD-4D192A9036AF}
  290.  *
  291.  */
  292.  DEFINE_GUID(IID_IHXFileObjectExt, 0x96dd5eb5, 0x7efd, 0x4084, 0x95, 0xcd, 0x4d,
  293.                        0x19, 0x2a, 0x90, 0x36, 0xaf);
  295. #undef  INTERFACE
  296. #define INTERFACE   IHXFileObjectExt
  298. DECLARE_INTERFACE_(IHXFileObjectExt, IUnknown)
  299. {
  300.     /*
  301.      *  IUnknown methods
  302.      */
  303.     STDMETHOD(QueryInterface)   (THIS_
  304.                 REFIID riid,
  305.                 void** ppvObj) PURE;
  307.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  309.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  311.     /************************************************************************
  312.      * Method:
  313.      *     IHXFileObjectExt::GetFullFilename
  314.      * Purpose:
  315.      *     Returns the filename, with path information, associated
  316.      *     with a file object.
  317.      *
  318.      *     Note: The returned pointer's lifetime expires as soon as the
  319.      *     caller returns from a function which was called from the RMA
  320.      *     core (i.e. when you return control to the RMA core)
  321.      *
  322.      */
  323.     STDMETHOD(GetFullFilename) (THIS_
  324.                                REF(IHXBuffer*)  /*OUT*/  pFullFilename) PURE;
  325. };
  328. /****************************************************************************
  329.  * 
  330.  *  Interface:
  331.  * 
  332.  * IHXFileResponse
  333.  * 
  334.  *  Purpose:
  335.  * 
  336.  * Object that exports file response API
  337.  * 
  338.  *  IID_IHXFileResponse:
  339.  * 
  340.  * {00000201-0901-11d1-8B06-00A024406D59}
  341.  * 
  342.  */
  343. DEFINE_GUID(IID_IHXFileResponse, 0x00000201, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  344. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  346. #undef  INTERFACE
  347. #define INTERFACE   IHXFileResponse
  349. DECLARE_INTERFACE_(IHXFileResponse, IUnknown)
  350. {
  351.     /*
  352.      * IUnknown methods
  353.      */
  354.     STDMETHOD(QueryInterface) (THIS_
  355. REFIID riid,
  356. void** ppvObj) PURE;
  358.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  360.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  362.     /*
  363.      * IHXFileResponse methods
  364.      */
  366.     /************************************************************************
  367.      * Method:
  368.      *     IHXFileResponse::InitDone
  369.      * Purpose:
  370.      *     Notification interface provided by users of the IHXFileObject
  371.      *     interface. This method is called by the IHXFileObject when the
  372.      *     initialization of the file is complete. If the file is not valid 
  373.      *     for the file system, the status HXR_FAILED should be 
  374.      *     returned.
  375.      */
  376.     STDMETHOD(InitDone) (THIS_
  377. HX_RESULT     status) PURE;
  379.     /************************************************************************
  380.      * Method:
  381.      *     IHXFileResponse::CloseDone
  382.      * Purpose:
  383.      *     Notification interface provided by users of the IHXFileObject
  384.      *     interface. This method is called by the IHXFileObject when the
  385.      *     close of the file is complete.
  386.      */
  387.     STDMETHOD(CloseDone) (THIS_
  388. HX_RESULT     status) PURE;
  390.     /************************************************************************
  391.      * Method:
  392.      *     IHXFileResponse::ReadDone
  393.      * Purpose:
  394.      *     Notification interface provided by users of the IHXFileObject
  395.      *     interface. This method is called by the IHXFileObject when the
  396.      *     last read from the file is complete and a buffer is available.
  397.      */
  398.     STDMETHOD(ReadDone) (THIS_ 
  399. HX_RESULT     status,
  400. IHXBuffer*     pBuffer) PURE;
  402.     /************************************************************************
  403.      * Method:
  404.      *     IHXFileResponse::WriteDone
  405.      * Purpose:
  406.      *     Notification interface provided by users of the IHXFileObject
  407.      *     interface. This method is called by the IHXFileObject when the
  408.      *     last write to the file is complete.
  409.      */
  410.     STDMETHOD(WriteDone) (THIS_ 
  411. HX_RESULT     status) PURE;
  413.     /************************************************************************
  414.      * Method:
  415.      *     IHXFileResponse::SeekDone
  416.      * Purpose:
  417.      *     Notification interface provided by users of the IHXFileObject
  418.      *     interface. This method is called by the IHXFileObject when the
  419.      *     last seek in the file is complete.
  420.      */
  421.     STDMETHOD(SeekDone) (THIS_ 
  422. HX_RESULT     status) PURE;
  423. };
  425. /****************************************************************************
  426.  * 
  427.  *  Interface:
  428.  * 
  429.  *      IHXAdvise
  430.  * 
  431.  *  Purpose:
  432.  * 
  433.  *      Allow IHXFileObject to query its IHXFileResponse interface
  434.  * 
  435.  *  IID_IHXAdvise:
  436.  * 
  437.  *      {43C3A3B8-8F76-4394-A4F8-07AA9091A0CA}
  438.  * 
  439.  */
  440. DEFINE_GUID(IID_IHXAdvise, 0x43c3a3b8, 0x8f76, 0x4394, 0xa4, 0xf8, 0x7, 
  441.                         0xaa, 0x90, 0x91, 0xa0, 0xca);
  443. #undef  INTERFACE
  444. #define INTERFACE   IHXAdvise
  446. DECLARE_INTERFACE_(IHXAdvise, IUnknown)
  447. {
  448.     /*
  449.      *  IUnknown methods
  450.      */
  451.     STDMETHOD(QueryInterface)           (THIS_
  452.                                         REFIID riid,
  453.                                         void** ppvObj) PURE;
  455.     STDMETHOD_(ULONG32,AddRef)          (THIS) PURE;
  457.     STDMETHOD_(ULONG32,Release)         (THIS) PURE;
  459.     /*
  460.      *  IHXAdvise methods
  461.      */
  463.     /************************************************************************
  464.      *  Method:
  465.      *      IHXAdvise::Advise
  466.      *  Purpose:
  467.      *      Allows IHXFileObject to query its IHXFileResponse about
  468.      *      usage heuristics. It should pass HX_FILERESPONSEADVISE_xxx
  469.      *      flags into this method.
  470.      */
  471.     STDMETHOD(Advise)   (THIS_ ULONG32 ulInfo) PURE;
  472. };
  475. /****************************************************************************
  476.  * 
  477.  *  Interface:
  478.  * 
  479.  * IHXFileSystemObject
  480.  * 
  481.  *  Purpose:
  482.  * 
  483.  * Object that allows a Controller to communicate with a specific
  484.  * File System plug-in session
  485.  * 
  486.  *  IID_IHXFileSystemObject:
  487.  * 
  488.  * {00000202-0901-11d1-8B06-00A024406D59}
  489.  * 
  490.  */
  491. DEFINE_GUID(IID_IHXFileSystemObject, 0x00000202, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  492. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  494. #undef  INTERFACE
  495. #define INTERFACE   IHXFileSystemObject
  497. DECLARE_INTERFACE_(IHXFileSystemObject, IUnknown)
  498. {
  499.     /*
  500.      * IUnknown methods
  501.      */
  502.     STDMETHOD(QueryInterface) (THIS_
  503. REFIID riid,
  504. void** ppvObj) PURE;
  506.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  508.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  510.     /*
  511.      * IHXFileSystemObject methods
  512.      */
  514.     /************************************************************************
  515.      * Method:
  516.      *     IHXFileSystemObject::GetFileSystemInfo
  517.      * Purpose:
  518.      *     Returns information vital to the instantiation of file system
  519.      *     plugin.
  520.      *
  521.      *     pShortName should be a short, human readable name in the form
  522.      *      of "company-fsname".  For example: pShortName = "pn-local".
  523.      */
  524.     STDMETHOD(GetFileSystemInfo)    (THIS_
  525.     REF(const char*) /*OUT*/ pShortName,
  526.     REF(const char*) /*OUT*/ pProtocol) PURE;
  528.     STDMETHOD(InitFileSystem) (THIS_
  529. IHXValues* pOptions) PURE;
  531.     STDMETHOD(CreateFile) (THIS_
  532. IUnknown**    /*OUT*/ ppFileObject) PURE;
  534.     /*
  535.      * The following method is deprecated and should return HXR_NOTIMPL
  536.      */
  538.     STDMETHOD(CreateDir) (THIS_
  539. IUnknown**   /*OUT*/ ppDirObject) PURE;
  541. };
  544. /****************************************************************************
  545.  * 
  546.  *  Interface:
  547.  * 
  548.  * IHXFileStat
  549.  * 
  550.  *  Purpose:
  551.  * 
  552.  *      Gets information about a specific File object
  553.  * 
  554.  *  IID_IHXFileStat:
  555.  *  
  556.  * {00000205-0901-11d1-8B06-00A024406D59}
  557.  * 
  558.  */
  559. DEFINE_GUID(IID_IHXFileStat, 0x00000205, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  560. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  562. #undef  INTERFACE
  563. #define INTERFACE   IHXFileStat
  565. DECLARE_INTERFACE_(IHXFileStat, IUnknown)
  566. {
  567.     /*
  568.      * IUnknown methods
  569.      */
  570.     STDMETHOD(QueryInterface)   (THIS_
  571.                                 REFIID riid,
  572.                                 void** ppvObj) PURE;
  574.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  576.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  578.     /*
  579.      * IHXFileStat methods
  580.      */
  582.     STDMETHOD(Stat) (THIS_
  583. IHXFileStatResponse* pFileStatResponse
  584. ) PURE;
  585. };
  588. /****************************************************************************
  589.  * 
  590.  *  Interface:
  591.  * 
  592.  * IHXFileStatResponse
  593.  * 
  594.  *  Purpose:
  595.  * 
  596.  *      Returns information about a specific File object
  597.  * 
  598.  *  IID_IHXFileStatResponse:
  599.  *  
  600.  * {00000206-0901-11d1-8B06-00A024406D59}
  601.  * 
  602.  */
  603. DEFINE_GUID(IID_IHXFileStatResponse, 0x00000206, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  604. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  606. #undef  INTERFACE
  607. #define INTERFACE   IHXFileStatResponse
  609. DECLARE_INTERFACE_(IHXFileStatResponse, IUnknown)
  610. {
  611.     /*
  612.      * IUnknown methods
  613.      */
  614.     STDMETHOD(QueryInterface)   (THIS_
  615.                                 REFIID riid,
  616.                                 void** ppvObj) PURE;
  618.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  620.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  622.     /*
  623.      * IHXFileStat methods
  624.      */
  626.     STDMETHOD(StatDone) (THIS_
  627.  HX_RESULT status,
  628.  UINT32 ulSize,
  629.  UINT32 ulCreationTime,
  630.  UINT32 ulAccessTime,
  631.  UINT32 ulModificationTime,
  632.  UINT32 ulMode) PURE;
  633. };
  635. /****************************************************************************
  636.  * 
  637.  *  Interface:
  638.  * 
  639.  * IHXFileSystemManager
  640.  * 
  641.  *  Purpose:
  642.  * 
  643.  *      Gives out File Objects based on URLs
  644.  * 
  645.  *  IID_IHXFileSystemManager:
  646.  *  
  647.  * {00000207-0901-11d1-8B06-00A024406D59}
  648.  * 
  649.  */
  650. DEFINE_GUID(IID_IHXFileSystemManager, 0x00000207, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  651. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  653. #undef  INTERFACE
  654. #define INTERFACE   IHXFileSystemManager
  656. #define CLSID_IHXFileSystemManager IID_IHXFileSystemManager
  658. DECLARE_INTERFACE_(IHXFileSystemManager, IUnknown)
  659. {
  660.     /*
  661.      * IUnknown methods
  662.      */
  663.     STDMETHOD(QueryInterface)   (THIS_
  664.                                 REFIID riid,
  665.                                 void** ppvObj) PURE;
  667.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  669.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  671.     /*
  672.      * IHXFileSystemManager methods
  673.      */
  675.     STDMETHOD(Init) (THIS_
  676.     IHXFileSystemManagerResponse* /*IN*/  pFileManagerResponse
  677.     ) PURE;
  679.     /* GetFileObject attempts to locate an existing file via the DoesExist
  680.      * method in each file system's objects, and returns that object through
  681.      * FSManagerResponse->FileObjectReady
  682.      */
  683.     STDMETHOD(GetFileObject) (THIS_
  684.  IHXRequest* pRequest,
  685.  IHXAuthenticator* pAuthenticator) PURE;
  687.     /* GetNewFileObject is similar to GetFileObject except that no DoesExist
  688.      * checks are done.  The first file system that matches the mount point
  689.      * or protocol for the path in the request object creates the file
  690.      * which is then returned through FileObjectReady.  This is especially
  691.      * useful for those who wish to open a brand new file for writing.
  692.      */
  693.     STDMETHOD(GetNewFileObject) (THIS_
  694.  IHXRequest* pRequest,
  695.  IHXAuthenticator* pAuthenticator) PURE;
  697.     STDMETHOD(GetRelativeFileObject) (THIS_
  698.       IUnknown* pOriginalObject,
  699.       const char* pPath) PURE;
  701.     /*
  702.      * The following method is deprecated and should return HXR_NOTIMPL
  703.      */
  705.     STDMETHOD(GetDirObjectFromURL) (THIS_
  706.                                         const char* pURL) PURE;
  707. };
  710. /****************************************************************************
  711.  * 
  712.  *  Interface:
  713.  * 
  714.  * IHXFileSystemManagerResponse
  715.  * 
  716.  *  Purpose:
  717.  * 
  718.  *      Gives out File System objects based on URLs
  719.  * 
  720.  *  IID_IHXFileSystemManagerResponse:
  721.  *  
  722.  * {00000208-0901-11d1-8B06-00A024406D59}
  723.  * 
  724.  */
  725. DEFINE_GUID(IID_IHXFileSystemManagerResponse, 0x00000208, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  726. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  728. #undef  INTERFACE
  729. #define INTERFACE   IHXFileSystemManagerResponse
  731. DECLARE_INTERFACE_(IHXFileSystemManagerResponse, IUnknown)
  732. {
  733.     /*
  734.      * IUnknown methods
  735.      */
  736.     STDMETHOD(QueryInterface)   (THIS_
  737.                                 REFIID riid,
  738.                                 void** ppvObj) PURE;
  740.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  742.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  744.     /*
  745.      * IHXFileSystemManagerResponse methods
  746.      */
  748.     /************************************************************************
  749.      * Method:
  750.      * IHXFileSystemManagerResponse::InitDone
  751.      * Purpose:
  752.      */
  753.     STDMETHOD(InitDone)     (THIS_
  754.     HX_RESULT     status) PURE;
  756.     STDMETHOD(FileObjectReady) (THIS_
  757. HX_RESULT status,
  758.                                 IUnknown* pObject) PURE;
  760.     /*
  761.      * The following method is deprecated and should return HXR_NOTIMPL
  762.      */
  764.     STDMETHOD(DirObjectReady) (THIS_
  765. HX_RESULT status,
  766.                                 IUnknown* pDirObject) PURE;
  767. };
  770. /****************************************************************************
  771.  * 
  772.  *  Interface:
  773.  * 
  774.  * IHXFileExists
  775.  * 
  776.  *  Purpose:
  777.  * 
  778.  * Checks for the existense of a file.  Must be implemented.
  779.  * 
  780.  *  IID_IHXFileExists:
  781.  * 
  782.  * {00000209-0901-11d1-8B06-00A024406D59}
  783.  * 
  784.  */
  785. DEFINE_GUID(IID_IHXFileExists, 0x00000209, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  786. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  788. #undef  INTERFACE
  789. #define INTERFACE   IHXFileExists
  791. DECLARE_INTERFACE_(IHXFileExists, IUnknown)
  792. {
  793.     /*
  794.      * IUnknown methods
  795.      */
  796.     STDMETHOD(QueryInterface) (THIS_
  797. REFIID riid,
  798. void** ppvObj) PURE;
  800.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  802.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  804.     /*
  805.      * IHXFileExists methods
  806.      */
  808.     /************************************************************************
  809.      * Method:
  810.      *     IHXFileExists::DoesExist
  811.      * Purpose:
  812.      */
  813.     STDMETHOD(DoesExist) (THIS_
  814. const char* /*IN*/  pPath, 
  815. IHXFileExistsResponse* /*IN*/  pFileResponse) PURE;
  816. };
  819. /****************************************************************************
  820.  * 
  821.  *  Interface:
  822.  * 
  823.  * IHXFileExistsResponse
  824.  * 
  825.  *  Purpose:
  826.  * 
  827.  * Response interface for IHXFileExists.  Must be implemented.
  828.  * 
  829.  *  IID_IHXFileExistsResponse:
  830.  * 
  831.  * {0000020A-0901-11d1-8B06-00A024406D59}
  832.  * 
  833.  */
  834. DEFINE_GUID(IID_IHXFileExistsResponse, 0x0000020a, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  835. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  837. #undef  INTERFACE
  838. #define INTERFACE   IHXFileExists
  840. DECLARE_INTERFACE_(IHXFileExistsResponse, IUnknown)
  841. {
  842.     /*
  843.      * IUnknown methods
  844.      */
  845.     STDMETHOD(QueryInterface) (THIS_
  846. REFIID riid,
  847. void** ppvObj) PURE;
  849.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  851.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  853.     /*
  854.      * IHXFileExistsResponse methods
  855.      */
  857.     STDMETHOD(DoesExistDone) (THIS_
  858.       BOOL bExist) PURE;
  859. };
  862. /****************************************************************************
  863.  * 
  864.  *  Interface:
  865.  * 
  866.  * IHXFileMimeMapper
  867.  * 
  868.  *  Purpose:
  869.  * 
  870.  * Allows you to specify a mime type for a specific file.
  871.  * Optional interface.
  872.  * 
  873.  *  IID_IHXFileMimeMapper:
  874.  * 
  875.  * {0000020B-0901-11d1-8B06-00A024406D59}
  876.  * 
  877.  */
  878. DEFINE_GUID(IID_IHXFileMimeMapper, 0x0000020b, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  879. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  881. #undef  INTERFACE
  882. #define INTERFACE   IHXFileMimeMapper
  884. DECLARE_INTERFACE_(IHXFileMimeMapper, IUnknown)
  885. {
  886.     /*
  887.      * IUnknown methods
  888.      */
  889.     STDMETHOD(QueryInterface) (THIS_
  890. REFIID riid,
  891. void** ppvObj) PURE;
  893.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  895.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  897.     /*
  898.      * IHXFileMimeMapper methods
  899.      */
  901.     /************************************************************************
  902.      * Method:
  903.      *     IHXFileMimeMapper::FindMimeType
  904.      * Purpose:
  905.      */
  906.     STDMETHOD(FindMimeType) (THIS_
  907.     const char*     /*IN*/  pURL, 
  908.     IHXFileMimeMapperResponse* /*IN*/  pMimeMapperResponse
  909.     ) PURE;
  910. };
  913. /****************************************************************************
  914.  * 
  915.  *  Interface:
  916.  * 
  917.  * IHXFileMimeMapperResponse
  918.  * 
  919.  *  Purpose:
  920.  * 
  921.  * Response interface for IHXFileMimeMapper.
  922.  * Optional interface.
  923.  * 
  924.  *  IID_IHXFileMimeMapperResponse:
  925.  * 
  926.  * {0000020C-0901-11d1-8B06-00A024406D59}
  927.  * 
  928.  */
  929. DEFINE_GUID(IID_IHXFileMimeMapperResponse, 0x0000020c, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  930. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  932. #undef  INTERFACE
  933. #define INTERFACE   IHXFileMimeMapperResponse
  935. DECLARE_INTERFACE_(IHXFileMimeMapperResponse, IUnknown)
  936. {
  937.     /*
  938.      * IUnknown methods
  939.      */
  940.     STDMETHOD(QueryInterface) (THIS_
  941. REFIID riid,
  942. void** ppvObj) PURE;
  944.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  946.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  948.     /*
  949.      * IHXFileMimeMapperResponse methods
  950.      */
  952.     /************************************************************************
  953.      * Method:
  954.      *     IHXFileMimeMapperResponse::MimeTypeFound
  955.      * Purpose:
  956.      *     Notification interface provided by users of the IHXFileMimeMapper
  957.      *     interface. This method is called by the IHXFileObject when the
  958.      *     initialization of the file is complete, and the Mime type is
  959.      *     available for the request file. If the file is not valid for the
  960.      *     file system, the status HXR_FAILED should be returned,
  961.      *     with a mime type of NULL. If the file is valid but the mime type
  962.      *     is unknown, then the status HXR_OK should be returned with
  963.      *     a mime type of NULL.
  964.      *     
  965.      */
  966.     STDMETHOD(MimeTypeFound) (THIS_
  967.       HX_RESULT status,
  968.       const char* pMimeType) PURE;
  969. };
  972. /****************************************************************************
  973.  * 
  974.  *  Interface:
  975.  * 
  976.  * IHXBroadcastMapper
  977.  * 
  978.  *  Purpose:
  979.  * 
  980.  * Associates a file with a broadcast format plugin.
  981.  * Implementation only required by broadcast plugin file systems.
  982.  * 
  983.  *  IID_IHXBroadcastMapper:
  984.  * 
  985.  * {0000020D-0901-11d1-8B06-00A024406D59}
  986.  * 
  987.  */
  988. DEFINE_GUID(IID_IHXBroadcastMapper, 0x0000020d, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  989. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  991. #undef  INTERFACE
  992. #define INTERFACE   IHXBroadcastMapper
  994. DECLARE_INTERFACE_(IHXBroadcastMapper, IUnknown)
  995. {
  996.     /*
  997.      * IUnknown methods
  998.      */
  999.     STDMETHOD(QueryInterface) (THIS_
  1000. REFIID riid,
  1001. void** ppvObj) PURE;
  1003.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1005.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1007.     /*
  1008.      * IHXBroadcastMapper methods
  1009.      */
  1011.     /************************************************************************
  1012.      * Method:
  1013.      *     IHXBroadcastMapper::FindBroadcastType
  1014.      * Purpose:
  1015.      */
  1016.     STDMETHOD(FindBroadcastType) (THIS_
  1017. const char*      /*IN*/  pURL, 
  1018. IHXBroadcastMapperResponse* /*IN*/  pBroadcastMapperResponse) PURE;
  1019. };
  1022. /****************************************************************************
  1023.  * 
  1024.  *  Interface:
  1025.  * 
  1026.  * IHXBroadcastMapperResponse
  1027.  * 
  1028.  *  Purpose:
  1029.  * 
  1030.  * Response interface for IHXBroadcastMapper.
  1031.  * Implementation only required by broadcast plugin file systems.
  1032.  * 
  1033.  *  IID_IHXBroadcastMapperResponse:
  1034.  * 
  1035.  * {0000020E-0901-11d1-8B06-00A024406D59}
  1036.  * 
  1037.  */
  1038. DEFINE_GUID(IID_IHXBroadcastMapperResponse, 0x0000020e, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1039. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1041. #undef  INTERFACE
  1042. #define INTERFACE   IHXBroadcastMapperResponse
  1044. DECLARE_INTERFACE_(IHXBroadcastMapperResponse, IUnknown)
  1045. {
  1046.     /*
  1047.      * IUnknown methods
  1048.      */
  1049.     STDMETHOD(QueryInterface) (THIS_
  1050. REFIID riid,
  1051. void** ppvObj) PURE;
  1053.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1055.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1057.     /*
  1058.      * IHXBroadcastMapperResponse methods
  1059.      */
  1061.     /************************************************************************
  1062.      * Method:
  1063.      *     IHXBroadcastMapperResponse::BroadcastTypeFound
  1064.      * Purpose:
  1065.      *     Notification interface provided by users of the IHXBroadcastMapper
  1066.      *     interface. This method is called by the File Object when the
  1067.      *     initialization of the file is complete, and the broadcast type is
  1068.      *     available for the request file. If the file is not valid for the
  1069.      *     file system, the status HXR_FAILED should be returned,
  1070.      *     with the broadcast type set to NULL.
  1071.      *     
  1072.      */
  1073.     STDMETHOD(BroadcastTypeFound) (THIS_
  1074.   HX_RESULT status,
  1075.   const char* pBroadcastType) PURE;
  1076. };
  1079. /****************************************************************************
  1080.  * 
  1081.  *  Interface:
  1082.  * 
  1083.  * IHXGetFileFromSamePool
  1084.  * 
  1085.  *  Purpose:
  1086.  * 
  1087.  *      Gives out File Objects based on filenames and relative "paths"
  1088.  * 
  1089.  *  IID_IHXGetFileFromSamePool:
  1090.  *  
  1091.  * {0000020f-0901-11d1-8B06-00A024406D59}
  1092.  * 
  1093.  */
  1094. DEFINE_GUID(IID_IHXGetFileFromSamePool, 0x0000020f, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1095. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1096. #undef  INTERFACE
  1097. #define INTERFACE   IHXGetFileFromSamePool
  1099. #define CLSID_IHXGetFileFromSamePool IID_IHXGetFileFromSamePool
  1101. DECLARE_INTERFACE_(IHXGetFileFromSamePool, IUnknown)
  1102. {
  1103.     /*
  1104.      * IUnknown methods
  1105.      */
  1106.     STDMETHOD(QueryInterface)   (THIS_
  1107.                                 REFIID riid,
  1108.                                 void** ppvObj) PURE;
  1110.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1112.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1115.     /*
  1116.      * IHXGetFileFromSamePool method
  1117.      */
  1118.     /************************************************************************
  1119.      * Method:
  1120.      *     IHXGetFileFromSamePool::GetFileObjectFromPool
  1121.      * Purpose:
  1122.      *      To get another FileObject from the same pool. 
  1123.      */
  1124.     STDMETHOD(GetFileObjectFromPool) (THIS_
  1125.  IHXGetFileFromSamePoolResponse*) PURE;
  1126. };
  1129. /****************************************************************************
  1130.  * 
  1131.  *  Interface:
  1132.  * 
  1133.  * IHXGetFileFromSamePoolResponse
  1134.  * 
  1135.  *  Purpose:
  1136.  * 
  1137.  *      Gives out File Objects based on filenames and relative "paths"
  1138.  * 
  1139.  *  IID_IHXGetFileFromSamePoolResponse:
  1140.  *  
  1141.  * {00000210-0901-11d1-8B06-00A024406D59}
  1142.  * 
  1143.  */
  1144. DEFINE_GUID(IID_IHXGetFileFromSamePoolResponse, 0x00000210, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1145. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1146. #undef  INTERFACE
  1147. #define INTERFACE   IHXGetFileFromSamePoolResponse
  1149. #define CLSID_IHXGetFileFromSamePoolResponse IID_IHXGetFileFromSamePoolResponse
  1151. DECLARE_INTERFACE_(IHXGetFileFromSamePoolResponse, IUnknown)
  1152. {
  1153.     /*
  1154.      * IUnknown methods
  1155.      */
  1156.     STDMETHOD(QueryInterface)   (THIS_
  1157.                                 REFIID riid,
  1158.                                 void** ppvObj) PURE;
  1160.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1162.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1164.     /*
  1165.      * IHXGetFileFromSamePoolResponse method
  1166.      */
  1167.     /************************************************************************
  1168.      * Method:
  1169.      *     IHXGetFileFromSamePoolResponse::FileObjectReady
  1170.      * Purpose:
  1171.      *      To return another FileObject from the same pool. 
  1172.      */
  1173.     STDMETHOD(FileObjectReady) (THIS_
  1174. HX_RESULT status,
  1175. IUnknown* ppUnknown) PURE;
  1176. };
  1179. /****************************************************************************
  1180.  * 
  1181.  *  Interface:
  1182.  * 
  1183.  * IHXFileAuthenticator
  1184.  * 
  1185.  *  Purpose:
  1186.  * 
  1187.  *      Set and Get a file object's authenticator object.
  1188.  * 
  1189.  *  IID_IHXFileAuthenticator:
  1190.  *  
  1191.  * {00000211-0901-11d1-8B06-00A024406D59}
  1192.  * 
  1193.  */
  1194. DEFINE_GUID(IID_IHXFileAuthenticator, 0x00000211, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1195. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1196. #undef  INTERFACE
  1197. #define INTERFACE   IHXFileAuthenticator
  1199. #define CLSID_IHXFileAuthenticator IID_IHXFileAuthenticator
  1201. DECLARE_INTERFACE_(IHXFileAuthenticator, IUnknown)
  1202. {
  1203.     /*
  1204.      * IUnknown methods
  1205.      */
  1206.     STDMETHOD(QueryInterface)   (THIS_
  1207.                                 REFIID riid,
  1208.                                 void** ppvObj) PURE;
  1210.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1212.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1214.     /*
  1215.      * IHXFileAuthenticator methods
  1216.      */
  1217.     STDMETHOD(SetAuthenticator) (THIS_
  1218.  IHXAuthenticator* pAuthenticator) PURE;
  1219.     
  1220.     STDMETHOD(GetAuthenticator) (THIS_
  1221.  REF(IHXAuthenticator*) pAuthenticator) PURE;
  1222. };
  1225. /****************************************************************************
  1226.  * 
  1227.  *  Interface:
  1228.  * 
  1229.  * IHXRequestHandler
  1230.  * 
  1231.  *  Purpose:
  1232.  * 
  1233.  *      Object to manage IHXRequest objects
  1234.  * 
  1235.  *  IID_IHXRequestHandler:
  1236.  *  
  1237.  * {00000212-0901-11d1-8B06-00A024406D59}
  1238.  * 
  1239.  */
  1240. DEFINE_GUID(IID_IHXRequestHandler, 0x00000212, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1241. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1242. #undef  INTERFACE
  1243. #define INTERFACE   IHXRequestHandler
  1245. #define CLSID_IHXRequestHandler IID_IHXRequestHandler
  1247. DECLARE_INTERFACE_(IHXRequestHandler, IUnknown)
  1248. {
  1249.     /*
  1250.      * IUnknown methods
  1251.      */
  1253.     STDMETHOD(QueryInterface)   (THIS_
  1254.                                 REFIID riid,
  1255.                                 void** ppvObj) PURE;
  1257.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1259.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1261.     /************************************************************************
  1262.      * Method:
  1263.      *     IHXRequestHandler::SetRequest
  1264.      * Purpose:
  1265.      *     Associates an IHXRequest with an object
  1266.      */
  1267.     STDMETHOD(SetRequest)   (THIS_
  1268.     IHXRequest*        /*IN*/  pRequest) PURE;
  1270.     /************************************************************************
  1271.      * Method:
  1272.      *     IHXRequestHandler::GetRequest
  1273.      * Purpose:
  1274.      *     Gets the IHXRequest object associated with an object
  1275.      */
  1276.     STDMETHOD(GetRequest)   (THIS_
  1277.     REF(IHXRequest*)        /*OUT*/  pRequest) PURE;
  1279. };
  1282. /****************************************************************************
  1283.  * 
  1284.  *  Interface:
  1285.  * 
  1286.  * IHXRequestContext
  1287.  * 
  1288.  *  Purpose:
  1289.  * 
  1290.  *      Object to manage the context of the Request
  1291.  * 
  1292.  *  IID_IHXRequestContext:
  1293.  *  
  1294.  * {00000217-0901-11d1-8B06-00A024406D59}
  1295.  * 
  1296.  */
  1297. DEFINE_GUID(IID_IHXRequestContext, 0x00000217, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1298. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1299. #undef  INTERFACE
  1300. #define INTERFACE   IHXRequestContext
  1302. #define CLSID_IHXRequestContext IID_IHXRequestContext
  1304. DECLARE_INTERFACE_(IHXRequestContext, IUnknown)
  1305. {
  1306.     /*
  1307.      * IUnknown methods
  1308.      */
  1310.     STDMETHOD(QueryInterface)   (THIS_
  1311.                                 REFIID riid,
  1312.                                 void** ppvObj) PURE;
  1314.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1316.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1318.     /*
  1319.      * IHXRequestContext methods
  1320.      */
  1322.     /************************************************************************
  1323.      * Method:
  1324.      *     IHXRequestContext::SetUserContext
  1325.      * Purpose:
  1326.      *     Sets the Authenticated users Context.
  1327.      */
  1328.     STDMETHOD(SetUserContext)
  1329.     (
  1330. THIS_
  1331. IUnknown* pIUnknownNewContext
  1332.     ) PURE;
  1334.     /************************************************************************
  1335.      * Method:
  1336.      *     IHXRequestContext::GetUserContext
  1337.      * Purpose:
  1338.      *     Gets the Authenticated users Context.
  1339.      */
  1340.     STDMETHOD(GetUserContext)
  1341.     (
  1342. THIS_
  1343. REF(IUnknown*) pIUnknownCurrentContext
  1344.     ) PURE;
  1346.     /************************************************************************
  1347.      * Method:
  1348.      *     IHXRequestContext::SetRequester
  1349.      * Purpose:
  1350.      *     Sets the Object that made the request.
  1351.      */
  1352.     STDMETHOD(SetRequester)
  1353.     (
  1354. THIS_
  1355. IUnknown* pIUnknownNewRequester
  1356.     ) PURE;
  1358.     /************************************************************************
  1359.      * Method:
  1360.      *     IHXRequestContext::GetRequester
  1361.      * Purpose:
  1362.      *     Gets the Object that made the request.
  1363.      */
  1364.     STDMETHOD(GetRequester)
  1365.     (
  1366. THIS_
  1367. REF(IUnknown*) pIUnknownCurrentRequester
  1368.     ) PURE;
  1369. };
  1371. /****************************************************************************
  1372.  * 
  1373.  *  Interface:
  1374.  * 
  1375.  * IHXRequest
  1376.  * 
  1377.  *  Purpose:
  1378.  * 
  1379.  *      Object to manage the RFC822 headers sent by the client
  1380.  * 
  1381.  *  IID_IHXRequest:
  1382.  *  
  1383.  * {00000213-0901-11d1-8B06-00A024406D59}
  1384.  * 
  1385.  */
  1386. DEFINE_GUID(IID_IHXRequest, 0x00000213, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1387. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1388. #undef  INTERFACE
  1389. #define INTERFACE   IHXRequest
  1391. #define CLSID_IHXRequest IID_IHXRequest
  1393. DECLARE_INTERFACE_(IHXRequest, IUnknown)
  1394. {
  1395.     /*
  1396.      * IUnknown methods
  1397.      */
  1399.     STDMETHOD(QueryInterface)   (THIS_
  1400.                                 REFIID riid,
  1401.                                 void** ppvObj) PURE;
  1403.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1405.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1407.     /*
  1408.      * IHXRequest methods
  1409.      */
  1411.     /************************************************************************
  1412.      * Method:
  1413.      *     IHXRequest::SetRequestHeaders
  1414.      * Purpose:
  1415.      *     Sets the headers that will be sent in the RFC822 header section
  1416.      *      of the request message
  1417.      */
  1418.     STDMETHOD(SetRequestHeaders) (THIS_
  1419. IHXValues* pRequestHeaders) PURE;
  1420.     
  1421.     /************************************************************************
  1422.      * Method:
  1423.      *     IHXRequest::GetRequestHeaders
  1424.      * Purpose:
  1425.      *     Gets the headers that were sent in the RFC822 header section
  1426.      *     of the request message
  1427.      */
  1428.     STDMETHOD(GetRequestHeaders) (THIS_
  1429. REF(IHXValues*) pRequestHeaders) PURE;
  1431.     /************************************************************************
  1432.      * Method:
  1433.      *     IHXRequest::SetResponseHeaders
  1434.      * Purpose:
  1435.      *     Sets the headers that will be returned in the RFC822 header
  1436.      *     section of the response message
  1437.      */
  1438.     STDMETHOD(SetResponseHeaders) (THIS_
  1439. IHXValues* pResponseHeaders) PURE;
  1440.     
  1441.     /************************************************************************
  1442.      * Method:
  1443.      *     IHXRequest::GetResponseHeaders
  1444.      * Purpose:
  1445.      *     Gets the headers that were returned in the RFC822 header section
  1446.      *     of the response message
  1447.      */
  1448.     STDMETHOD(GetResponseHeaders) (THIS_
  1449. REF(IHXValues*) pResponseHeaders) PURE;
  1451.     /************************************************************************
  1452.      * Method:
  1453.      *     IHXRequest::SetURL
  1454.      * Purpose:
  1455.      *     Sets the fully qualified path associated with a file object.
  1456.      *     Note: On the server, this path does not include the file system
  1457.      *      mount point.
  1458.      */
  1459.     STDMETHOD(SetURL) (THIS_
  1460. const char* pURL) PURE;
  1462.     /************************************************************************
  1463.      * Method:
  1464.      *     IHXRequest::GetURL
  1465.      * Purpose:
  1466.      *     Returns the fully qualified path associated with a file object.
  1467.      *     Note: On the server, this path does not include the file system
  1468.      *      mount point.
  1469.      *
  1470.      *     Note: The returned pointer's lifetime expires as soon as the
  1471.      *     caller returns from a function which was called from the RMA
  1472.      *     core (i.e. when you return control to the RMA core)
  1473.      */
  1474.     STDMETHOD(GetURL) (THIS_
  1475. REF(const char*) pURL) PURE;
  1476. };
  1478. /****************************************************************************
  1479.  * 
  1480.  *  Interface:
  1481.  * 
  1482.  * IHXFileRename
  1483.  * 
  1484.  *  Purpose:
  1485.  * 
  1486.  *      Interface to allow renaming of files.  Query off of the File Object.
  1487.  * Not all filesystem plugins implement this feature.
  1488.  * 
  1489.  *  IID_IHXFileRename:
  1490.  *  
  1491.  * {00000214-0901-11d1-8B06-00A024406D59}
  1492.  * 
  1493.  */
  1494. DEFINE_GUID(IID_IHXFileRename, 0x00000214, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1495. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1496. #undef  INTERFACE
  1497. #define INTERFACE   IHXFileRename
  1499. DECLARE_INTERFACE_(IHXFileRename, IUnknown)
  1500. {
  1501.     /*
  1502.      * IUnknown methods
  1503.      */
  1505.     STDMETHOD(QueryInterface)   (THIS_
  1506.                                 REFIID riid,
  1507.                                 void** ppvObj) PURE;
  1509.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1511.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1513.     /*
  1514.      * IHXFileRename methods
  1515.      */
  1517.     /************************************************************************
  1518.      * Method:
  1519.      *     IHXFileRename::Rename
  1520.      * Purpose:
  1521.      *     Renames a file to a new name.
  1522.      */
  1523.     STDMETHOD(Rename) (THIS_
  1524. const char* pNewFileName) PURE;
  1525. };
  1528. /****************************************************************************
  1529.  * 
  1530.  *  Interface:
  1531.  * 
  1532.  * IHXFileMove
  1533.  * 
  1534.  *  Purpose:
  1535.  * 
  1536.  *      Interface to allow removing of files.  Query off of the File Object.
  1537.  * Not all filesystem plugins implement this feature.
  1538.  * 
  1539.  *  IID_IHXFileMove:
  1540.  *  
  1541.  * {23E72FB0-DE0E-11d5-AA9A-00010251B340}
  1542.  * 
  1543.  */
  1544. DEFINE_GUID(IID_IHXFileMove, 0x23e72fb0, 0xde0e, 0x11d5, 0xaa, 0x9a, 0x0, 
  1545. 0x1, 0x2, 0x51, 0xb3, 0x40);
  1547. #undef  INTERFACE
  1548. #define INTERFACE   IHXFileMove
  1550. DECLARE_INTERFACE_(IHXFileMove, IUnknown)
  1551. {
  1552.     /*
  1553.      * IUnknown methods
  1554.      */
  1556.     STDMETHOD(QueryInterface)   (THIS_
  1557.                                 REFIID riid,
  1558.                                 void** ppvObj) PURE;
  1560.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1562.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1564.     /*
  1565.      * IHXFileMove methods
  1566.      */
  1568.     /************************************************************************
  1569.      * Method:
  1570.      *     IHXFileMove::Move
  1571.      * Purpose:
  1572.      *     Moves a file to a different location in the file system
  1573.      */
  1574.     STDMETHOD(Move) (THIS_
  1575. const char* pNewFilePathName) PURE;
  1576. };
  1577.     
  1579. /****************************************************************************
  1580.  * 
  1581.  *  Interface:
  1582.  * 
  1583.  * IHXDirHandler
  1584.  * 
  1585.  *  Purpose:
  1586.  * 
  1587.  * Object that exports directory handler API
  1588.  * 
  1589.  *  IID_IHXDirHandler:
  1590.  * 
  1591.  * {00000215-0901-11d1-8B06-00A024406D59}
  1592.  * 
  1593.  */
  1594. DEFINE_GUID(IID_IHXDirHandler, 0x00000215, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1596. #undef  INTERFACE
  1597. #define INTERFACE   IHXDirHandler
  1599. DECLARE_INTERFACE_(IHXDirHandler, IUnknown)
  1600. {
  1601.     /*
  1602.      * IUnknown methods
  1603.      */
  1604.     STDMETHOD(QueryInterface) (THIS_
  1605. REFIID riid,
  1606. void** ppvObj) PURE;
  1608.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1610.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1612.     /*
  1613.      * IHXDirHandler methods
  1614.      */
  1616.     /************************************************************************
  1617.      * Method:
  1618.      *     IHXDirHandler::InitDirHandler
  1619.      * Purpose:
  1620.      *     Associates a directory handler with the directory handler
  1621.      *     response, it should notify of operation completness.
  1622.      */
  1623.     STDMETHOD(InitDirHandler) (THIS_
  1624. IHXDirHandlerResponse*    /*IN*/  pDirResponse) PURE;
  1626.     /************************************************************************
  1627.      * Method:
  1628.      *     IHXDirHandler::CloseDirHandler
  1629.      * Purpose:
  1630.      *     Closes the directory handler resource and releases all resources
  1631.      *     associated with the object.
  1632.      */
  1633.     STDMETHOD(CloseDirHandler) (THIS) PURE;
  1635.     /************************************************************************
  1636.      * Method:
  1637.      *     IHXDirHandler::MakeDir
  1638.      * Purpose:
  1639.      *     Create the directory
  1640.      */
  1641.     STDMETHOD(MakeDir) (THIS) PURE;
  1643.     /************************************************************************
  1644.      * Method:
  1645.      *     IHXDirHandler::ReadDir
  1646.      * Purpose:
  1647.      *     Get a dump of the directory
  1648.      */
  1649.     STDMETHOD(ReadDir) (THIS) PURE;
  1650. };
  1653. /****************************************************************************
  1654.  * 
  1655.  *  Interface:
  1656.  * 
  1657.  * IHXDirHandlerResponse
  1658.  * 
  1659.  *  Purpose:
  1660.  * 
  1661.  * Object that exports the directory handler response API
  1662.  * 
  1663.  *  IID_IHXDirHandlerResponse:
  1664.  * 
  1665.  * {00000216-0901-11d1-8B06-00A024406D59}
  1666.  * 
  1667.  */
  1668. DEFINE_GUID(IID_IHXDirHandlerResponse, 0x00000216, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1670. #undef  INTERFACE
  1671. #define INTERFACE   IHXDirHandlerResponse
  1673. DECLARE_INTERFACE_(IHXDirHandlerResponse, IUnknown)
  1674. {
  1675.     /*
  1676.      * IUnknown methods
  1677.      */
  1678.     STDMETHOD(QueryInterface) (THIS_
  1679. REFIID riid,
  1680. void** ppvObj) PURE;
  1682.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1684.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1686.     /*
  1687.      * IHXDirHandlerResponse methods
  1688.      */
  1690.     /************************************************************************
  1691.      * Method:
  1692.      *     IHXDirHandlerResponse::InitDirHandlerDone
  1693.      * Purpose:
  1694.      *     Notification interface provided by users of the IHXDirHandler
  1695.      *     interface. This method is called by the IHXDirHandler when the
  1696.      *     initialization of the object is complete.
  1697.      */
  1698.     STDMETHOD(InitDirHandlerDone) (THIS_
  1699. HX_RESULT     status) PURE;
  1701.     /************************************************************************
  1702.      * Method:
  1703.      *     IHXDirHandlerResponse::CloseDirHandlerDone
  1704.      * Purpose:
  1705.      *     Notification interface provided by users of the IHXDirHandler
  1706.      *     interface. This method is called by the IHXDirHandler when the
  1707.      *     close of the directory is complete.
  1708.      */
  1709.     STDMETHOD(CloseDirHandlerDone) (THIS_
  1710. HX_RESULT     status) PURE;
  1712.     /************************************************************************
  1713.      * Method:
  1714.      *     IHXDirHandler::MakeDirDone
  1715.      * Purpose:
  1716.      *     Notification interface provided by users of the IHXDirHandler
  1717.      *     interface. This method is called by the IHXDirHandler when the
  1718.      *     attempt to create the directory is complete.
  1719.      */
  1720.     STDMETHOD(MakeDirDone) (THIS_ 
  1721. HX_RESULT     status) PURE;
  1723.     /************************************************************************
  1724.      * Method:
  1725.      *     IHXDirHandler::ReadDirDone
  1726.      * Purpose:
  1727.      *     Notification interface provided by users of the IHXDirHandler
  1728.      *     interface. This method is called by the IHXDirHandler when the
  1729.      *     read from the directory is complete and a buffer is available.
  1730.      */
  1731.     STDMETHOD(ReadDirDone) (THIS_ 
  1732. HX_RESULT     status,
  1733. IHXBuffer*     pBuffer) PURE;
  1734. };
  1737. // $Private:
  1738. /****************************************************************************
  1739.  * 
  1740.  *  Interface:
  1741.  * 
  1742.  * IHXGetRecursionLevel
  1743.  * 
  1744.  *  Purpose:
  1745.  * 
  1746.  * Set's Recursion Level
  1747.  * 
  1748.  *  IID_GetRecursionLevel:
  1749.  * 
  1750.  * {00000218-0901-11d1-8B06-00A024406D59}
  1751.  * 
  1752.  */
  1753. DEFINE_GUID(IID_IHXGetRecursionLevel, 0x00000218, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1755. #undef  INTERFACE
  1756. #define INTERFACE   IHXGetRecursionLevel
  1758. DECLARE_INTERFACE_(IHXGetRecursionLevel, IUnknown)
  1759. {
  1760.     /*
  1761.      * IUnknown methods
  1762.      */
  1763.     STDMETHOD(QueryInterface) (THIS_
  1764. REFIID riid,
  1765. void** ppvObj) PURE;
  1767.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1769.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1771.     /*
  1772.      * IHXGetRecursionLevel methods
  1773.      */
  1775.     STDMETHOD_(UINT32, GetRecursionLevel) (THIS) PURE;
  1776. };
  1778. /****************************************************************************
  1779.  * 
  1780.  *  Interface:
  1781.  * 
  1782.  * IHXFileRestrictor
  1783.  * 
  1784.  *  Purpose:
  1785.  * 
  1786.  * Allows restrictions on per file basis.  This will only get called for
  1787.  *  HTTP and it will only send in the localport.  Maybe some day.....
  1788.  * 
  1789.  *  IID_IHXFileRestrictor:
  1790.  * 
  1791.  * {00000219-0901-11d1-8B06-00A024406D59}
  1792.  * 
  1793.  */
  1794. DEFINE_GUID(IID_IHXFileRestrictor, 0x00000219, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1796. #undef  INTERFACE
  1797. #define INTERFACE   IHXFileRestrictor
  1799. DECLARE_INTERFACE_(IHXFileRestrictor, IUnknown)
  1800. {
  1801.     /*
  1802.      * IUnknown methods
  1803.      */
  1804.     STDMETHOD(QueryInterface) (THIS_
  1805. REFIID riid,
  1806. void** ppvObj) PURE;
  1808.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  1810.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1812.     /*
  1813.      * IHXFileRestrictor methods
  1814.      */
  1816.     STDMETHOD_(BOOL, IsAllowed) (THIS_
  1817. const char* url,
  1818. ULONG32 LocalAddr,
  1819. UINT16 LocalPort,
  1820. ULONG32 RemoteAddr,
  1821. UINT16 RemotePort) PURE;
  1822. };
  1824. // $EndPrivate.
  1826. /****************************************************************************
  1827.  * 
  1828.  *  Interface:
  1829.  * 
  1830.  * IHXFileRemove
  1831.  * 
  1832.  *  Purpose:
  1833.  * 
  1834.  *      Interface to allow removing of files.  Query off of the File Object.
  1835.  * Not all filesystem plugins implement this feature.
  1836.  * 
  1837.  *  IID_IHXFileRemove:
  1838.  *  
  1839.  * {0000021A-0901-11d1-8B06-00A024406D59}
  1840.  * 
  1841.  */
  1842. DEFINE_GUID(IID_IHXFileRemove, 0x0000021A, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1843. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1844. #undef  INTERFACE
  1845. #define INTERFACE   IHXFileRemove
  1847. DECLARE_INTERFACE_(IHXFileRemove, IUnknown)
  1848. {
  1849.     /*
  1850.      * IUnknown methods
  1851.      */
  1853.     STDMETHOD(QueryInterface)   (THIS_
  1854.                                 REFIID riid,
  1855.                                 void** ppvObj) PURE;
  1857.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1859.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1861.     /*
  1862.      * IHXFileRemove methods
  1863.      */
  1865.     /************************************************************************
  1866.      * Method:
  1867.      *     IHXFileRemove::Remove
  1868.      * Purpose:
  1869.      *     Removes a file from the file system.
  1870.      */
  1871.     STDMETHOD(Remove) (THIS) PURE;
  1872. };
  1875. // $Private:
  1876. /****************************************************************************
  1877.  * 
  1878.  *  Interface:
  1879.  * 
  1880.  * IHXFastFileFactory
  1881.  * 
  1882.  *  Purpose:
  1883.  * 
  1884.  *      Interface to allow wrapping file objects with a buffer and block-sharing
  1885.  * sceme.  Query off the server class factory.
  1886.  * 
  1887.  *  IID_IHXFastFileFactory:
  1888.  *  
  1889.  * {0000021C-0901-11d1-8B06-00A024406D59}
  1890.  * 
  1891.  */
  1892. DEFINE_GUID(IID_IHXFastFileFactory, 0x0000021C, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1893. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1895. #define CLSID_IHXFastFileFactory IID_IHXFastFileFactory
  1897. #undef  INTERFACE
  1898. #define INTERFACE   IHXFastFileFactory
  1900. DECLARE_INTERFACE_(IHXFastFileFactory, IUnknown)
  1901. {
  1902.     /*
  1903.      * IUnknown methods
  1904.      */
  1906.     STDMETHOD(QueryInterface)   (THIS_
  1907.                                 REFIID riid,
  1908.                                 void** ppvObj) PURE;
  1910.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  1912.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  1914.     /*
  1915.      * IHXFastFileFactory methods
  1916.      */
  1918.     /************************************************************************
  1919.      * Method:
  1920.      *     IHXFastFileFactory::Wrap
  1921.      * Purpose:
  1922.      *     Return an instantiated wrapper around an existing (but
  1923.      *      uninitialized) file object.
  1924.      *
  1925.      */
  1926.     STDMETHOD(Wrap) (THIS_
  1927.  REF(IUnknown*) /*OUT*/ pWrapper,
  1928.  IUnknown*      /*IN*/  pFileObj,
  1929.  UINT32         /*IN*/  ulBlockSize,
  1930.                                  BOOL           /*IN*/  bAlignReads,
  1931.                                  BOOL           /*IN*/  bCacheStats) PURE;
  1932. };
  1935. /****************************************************************************
  1936.  *
  1937.  *  Interface:
  1938.  *
  1939.  *      IHXFastFileFactory2
  1940.  *
  1941.  *  Purpose:
  1942.  *
  1943.  *      Interface to allow wrapping file objects with a buffer and block-sharing
  1944.  *      sceme.  Query off the server class factory.
  1945.  *
  1946.  *  IID_IHXFastFileFactory2:
  1947.  * 
  1948.  *      {0000021F-0901-11d1-8B06-00A024406D59}
  1949.  *
  1950.  */
  1951. DEFINE_GUID(IID_IHXFastFileFactory2, 0x0000021F, 0x901, 0x11d1, 0x8b, 0x6, 0x0,
  1952.                         0xa0, 0x24, 0x40, 0x6d, 0x59);
  1954. #define CLSID_IHXFastFileFactory2 IID_IHXFastFileFactory2
  1956. #undef  INTERFACE
  1957. #define INTERFACE   IHXFastFileFactory2
  1959. DECLARE_INTERFACE_(IHXFastFileFactory2, IUnknown)
  1960. {
  1961.     /************************************************************************
  1962.      *  Method:
  1963.      *      IHXFastFileFactory2::Wrap
  1964.      *  Purpose:
  1965.      *      Return an instantiated wrapper around an existing (but
  1966.      *      uninitialized) file object.
  1967.      *
  1968.      */
  1969.     STDMETHOD(Wrap)             (THIS_
  1970.                                  REF(IUnknown*) /*OUT*/ pWrapper,
  1971.                                  IUnknown*      /*IN*/  pFileObj,
  1972.                                  UINT32         /*IN*/  ulBlockSize,
  1973.                                  BOOL           /*IN*/  bAlignReads,
  1974.                                  BOOL           /*IN*/  bCacheStats,
  1975.                                  UINT32         /*IN*/  ulMaxBlockSize) PURE;
  1976. };
  1979. /****************************************************************************
  1980.  * 
  1981.  *  Interface:
  1982.  * 
  1983.  * IHXFilePlacementRead
  1984.  * 
  1985.  *  Purpose:
  1986.  * 
  1987.  *      Reads into the passed buffer
  1988.  * 
  1989.  *  IID_IHXFilePlacementRead
  1990.  * 
  1991.  * {0000021D-0901-11d1-8B06-00A024406D59}
  1992.  * 
  1993.  */
  1994. DEFINE_GUID(IID_IHXFilePlacementRead, 0x0000021D, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  1995. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  1997. #undef  INTERFACE
  1998. #define INTERFACE   IHXFilePlacementRead
  2000. DECLARE_INTERFACE_(IHXFilePlacementRead, IUnknown)
  2001. {
  2002.     /*
  2003.      * IUnknown methods
  2004.      */
  2005.     STDMETHOD(QueryInterface)   (THIS_
  2006.                                 REFIID riid,
  2007.                                 void** ppvObj) PURE;
  2009.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  2011.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2013.     /*
  2014.      * IHXFilePlacementRead methods
  2015.      */
  2016.     STDMETHOD(Read) (THIS_
  2017.                                 ULONG32 ulAmount,
  2018.                                 ULONG32 ulOffset,
  2019.                                 char*   pBuffer,
  2020.                                 BOOL    bOffsetBuffer) PURE;
  2022.     STDMETHOD_(ULONG32,AlignmentBoundary) (THIS) PURE;
  2023. };
  2025. // $EndPrivate.
  2027. /****************************************************************************
  2028.  * 
  2029.  *  Interface:
  2030.  * 
  2031.  * IHXFastFileStats
  2032.  * 
  2033.  *  Purpose:
  2034.  * 
  2035.  *      Interface to allow file objects to request that at close they be 
  2036.  *      informed how many bytes have been "fast cached" on their behalf if any.
  2037.  * 
  2038.  *      ulFastFileBytesSaved is the number of bytes that would have been read
  2039.  *      from the file object had FastFile not been in use (this includes some
  2040.  *      lookahead
  2041.  *
  2042.  *      ulFastFileBytesNeeded is the amount of data actually read by the file 
  2043.  *      system. 
  2044.  * 
  2045.  *  IID_IHXFastFileStats:
  2046.  *  
  2047.  * {0000021E-0901-11d1-8B06-00A024406D59}
  2048.  * 
  2049.  */
  2050. DEFINE_GUID(IID_IHXFastFileStats, 0x0000021E, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  2051. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  2053. #define CLSID_IHXFastFileStats IID_IHXFastFileStats
  2055. #undef  INTERFACE
  2056. #define INTERFACE   IHXFastFileStats
  2058. DECLARE_INTERFACE_(IHXFastFileStats, IUnknown)
  2059. {
  2060.     /*
  2061.      * IUnknown methods
  2062.      */
  2064.     STDMETHOD(QueryInterface)   (THIS_
  2065.                                 REFIID riid,
  2066.                                 void** ppvObj) PURE;
  2068.     STDMETHOD_(ULONG32,AddRef)  (THIS) PURE;
  2070.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2072.     /*
  2073.      * IHXFastFileStats methods
  2074.      */
  2076.     STDMETHOD(UpdateFileObjectStats) (THIS_
  2077.                                          UINT32         /*IN*/  ulFastFileBytesSaved,
  2078.                                          UINT32         /*IN*/  ulFastFileBytesNeeded) PURE;
  2079. };
  2081. // $Private:
  2082. /****************************************************************************
  2083.  * 
  2084.  *  Interface:
  2085.  * 
  2086.  * IHXHTTPPostObject
  2087.  * 
  2088.  *  Purpose:
  2089.  * 
  2090.  * Object that exports file control API
  2091.  * 
  2092.  *  IID_IHXHTTPPostObject:
  2093.  * 
  2094.  * {00000112-0901-11d1-8B06-00A024406D59}
  2095.  * 
  2096.  */
  2098. DEFINE_GUID(IID_IHXHTTPPostObject, 0x00000112, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  2099. 0xa0, 0x24, 0x40, 0x6d, 0x59);
  2101. #define CLSID_IHXHTTPPostObject IID_IHXHTTPPostObject
  2103. #undef  INTERFACE
  2104. #define INTERFACE   IHXHTTPPostObject
  2106. DECLARE_INTERFACE_(IHXHTTPPostObject, IUnknown)
  2107. {
  2108.     /*
  2109.      * IUnknown methods
  2110.      */
  2111.     STDMETHOD(QueryInterface) (THIS_
  2112. REFIID riid,
  2113. void** ppvObj) PURE;
  2115.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2117.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2119.     /*
  2120.      * IHXHTTPPostObject methods
  2121.      */
  2123.     /************************************************************************
  2124.      * Method:
  2125.      *     IHXHTTPPostObject::Init
  2126.      * Purpose:
  2127.      *     Associates a file object with the file response object it should
  2128.      *     notify of operation completness. This method should also check
  2129.      *     for validity of the object (for example by opening it if it is
  2130.      *     a local file).
  2131.      */
  2132.     STDMETHOD(Init) (THIS_
  2133. ULONG32     /*IN*/  ulFlags,
  2134. IHXHTTPPostResponse*   /*IN*/  pFileResponse) PURE;
  2136.     /************************************************************************
  2137.      * Method:
  2138.      *     IHXHTTPPostObject::Close
  2139.      * Purpose:
  2140.      *     Closes the file resource and releases all resources associated
  2141.      *     with the object.
  2142.      */
  2143.     STDMETHOD(Close) (THIS) PURE;
  2145.     /************************************************************************
  2146.      * Method:
  2147.      *     IHXHTTPPostObject::GetResponse
  2148.      * Purpose:
  2149.      *     Tells the object to retreive any response data from the POST.
  2150.      *     Calls IHXHTTPPostResponse with ResponseReady(IHXValues*).
  2151.      */
  2152.     STDMETHOD(GetResponse) (THIS) PURE;
  2155.     /************************************************************************
  2156.      * Method:
  2157.      *     IHXHTTPPostObject::Post
  2158.      * Purpose:
  2159.      *     Writes a buffer of data to the HTTP URL and asynchronously notifies
  2160.      *     the caller via the IHXFileResponse interface passed in to Init,
  2161.      *     of the completeness of the operation.
  2162.      */
  2163.     STDMETHOD(Post) (THIS_
  2164. IHXBuffer* pBuffer) PURE;
  2166. /************************************************************************
  2167.      * Method:
  2168.      *     IHXHTTPPostObject::SetSize
  2169.      * Purpose:
  2170.      *      Set the total size of the Post(s) about to be made.
  2171.      */
  2172.     STDMETHOD(SetSize) (THIS_
  2173. ULONG32 ulLength) PURE;
  2174. };
  2177. /****************************************************************************
  2178.  * 
  2179.  *  Interface:
  2180.  * 
  2181.  * IHXHTTPPostResponse
  2182.  * 
  2183.  *  Purpose:
  2184.  * 
  2185.  * Object that exports file response API
  2186.  * 
  2187.  *  IID_IHXHTTPPostResponse:
  2188.  * 
  2189.  * {00000113-0901-11d1-8B06-00A024406D59}
  2190.  * 
  2191.  */
  2192. DEFINE_GUID(IID_IHXHTTPPostResponse, 0x00000113, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 
  2193.     0xa0, 0x24, 0x40, 0x6d, 0x59);
  2195. #undef  INTERFACE
  2196. #define INTERFACE   IHXHTTPPostResponse
  2198. DECLARE_INTERFACE_(IHXHTTPPostResponse, IUnknown)
  2199. {
  2200.     /*
  2201.      * IUnknown methods
  2202.      */
  2203.     STDMETHOD(QueryInterface) (THIS_
  2204. REFIID riid,
  2205. void** ppvObj) PURE;
  2207.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2209.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2211.     /*
  2212.      * IHXHTTPPostResponse methods
  2213.      */
  2215.     /************************************************************************
  2216.      * Method:
  2217.      *     IHXHTTPPostResponse::InitDone
  2218.      * Purpose:
  2219.      *     Notification interface provided by users of the IHXHTTPPostObject
  2220.      *     interface. This method is called by the IHXHTTPPostObject when the
  2221.      *     initialization of the file is complete. If the file is not valid 
  2222.      *     for the file system, the status HXR_FAILED should be 
  2223.      *     returned.
  2224.      */
  2225.     STDMETHOD(InitDone) (THIS_
  2226. HX_RESULT     status) PURE;
  2228.     /************************************************************************
  2229.      * Method:
  2230.      *     IHXHTTPPostResponse::CloseDone
  2231.      * Purpose:
  2232.      *     Notification interface provided by users of the IHXHTTPPostObject
  2233.      *     interface. This method is called by the IHXHTTPPostObject when the
  2234.      *     close of the file is complete.
  2235.      */
  2236.     STDMETHOD(CloseDone) (THIS_
  2237. HX_RESULT     status) PURE;
  2239.     /************************************************************************
  2240.      * Method:
  2241.      *     IHXHTTPPostResponse::ResponseReady
  2242.      * Purpose:
  2243.      *     Notification interface provided by users of the IHXHTTPPostObject
  2244.      *     interface. This method is called by the IHXHTTPPostObject when the
  2245.      *     POST response data has been completely read.
  2246.      */
  2247.     STDMETHOD(ResponseReady) (THIS_ 
  2248. HX_RESULT     status,
  2249. IHXBuffer*     pContentBuffer) PURE;
  2251.     /************************************************************************
  2252.      * Method:
  2253.      *     IHXHTTPPostResponse::WriteDone
  2254.      * Purpose:
  2255.      *     Notification interface provided by users of the IHXHTTPPostObject
  2256.      *     interface. This method is called by the IHXHTTPPostObject when the
  2257.      *     last write to the file is complete.
  2258.      */
  2259.     STDMETHOD(PostDone) (THIS_ 
  2260. HX_RESULT     status) PURE;
  2261. };
  2262. // $EndPrivate.
  2265. // $Private:
  2266. /****************************************************************************
  2267.  * 
  2268.  *  Interface:
  2269.  * 
  2270.  * IHXHTTPRedirect
  2271.  * 
  2272.  *  Purpose:
  2273.  * 
  2274.  * Allows you to get redirect URL
  2275.  * 
  2276.  *  IID_IHXHTTPRedirect:
  2277.  * 
  2278.  * {00002E00-0901-11d1-8B06-00A024406D59}
  2279.  * 
  2280.  */
  2282. DEFINE_GUID(IID_IHXHTTPRedirect, 0x21eae0b9, 0x2e0c, 0x4003, 0xbb, 0x79,
  2283.             0xbc, 0x8c, 0xc5, 0x67, 0x2c, 0x2d);
  2285. #undef  INTERFACE
  2286. #define INTERFACE   IHXHTTPRedirect
  2288. DECLARE_INTERFACE_(IHXHTTPRedirect, IUnknown)
  2289. {
  2290.     /*
  2291.      * IUnknown methods
  2292.      */
  2293.     STDMETHOD(QueryInterface) (THIS_
  2294. REFIID riid,
  2295. void** ppvObj) PURE;
  2297.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2299.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2301.     /*
  2302.      * IHXHTTPRedirect methods
  2303.      */
  2305.     /************************************************************************
  2306.      * Method:
  2307.      *     IHXHTTPRedirect::Init
  2308.      * Purpose:
  2309.      *     Initialize the response object
  2310.      */
  2311.     STDMETHOD(Init)     (THIS_
  2312.      IHXHTTPRedirectResponse* pRedirectResponse) PURE;
  2314.     /************************************************************************
  2315.      * Method:
  2316.      *     IHXHTTPRedirect::SetResponseObject
  2317.      * Purpose:
  2318.      *     Initialize the response object w/o calling Init
  2319.      */
  2320.     STDMETHOD(SetResponseObject) (THIS_ 
  2321.                              IHXHTTPRedirectResponse* pRedirectResponse) PURE;
  2323. };
  2325. /****************************************************************************
  2326.  * 
  2327.  *  Interface:
  2328.  * 
  2329.  * IHXHTTPRedirectResponse
  2330.  * 
  2331.  *  Purpose:
  2332.  * 
  2333.  * Allows you to get redirect URL
  2334.  * 
  2335.  *  IID_IHXHTTPRedirectResponse:
  2336.  * 
  2337.  * {00002E01-0901-11d1-8B06-00A024406D59}
  2338.  * 
  2339.  */
  2341. DEFINE_GUID(IID_IHXHTTPRedirectResponse, 0x125a63b1, 0x669c, 0x42f9, 0xb1,
  2342.             0xf9, 0x1b, 0x53, 0xe9, 0x95, 0x82, 0x95);
  2344. #undef  INTERFACE
  2345. #define INTERFACE   IHXHTTPRedirectResponse
  2347. DECLARE_INTERFACE_(IHXHTTPRedirectResponse, IUnknown)
  2348. {
  2349.     /*
  2350.      * IUnknown methods
  2351.      */
  2352.     STDMETHOD(QueryInterface) (THIS_
  2353. REFIID riid,
  2354. void** ppvObj) PURE;
  2356.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2358.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2360.     /*
  2361.      * IHXHTTPRedirectResponse methods
  2362.      */
  2364.     /************************************************************************
  2365.      * Method:
  2366.      *     IHXHTTPRedirectResponse::RedirectDone
  2367.      * Purpose:
  2368.      *     return the redirect URL
  2369.      */
  2370.     STDMETHOD(RedirectDone) (THIS_
  2371.  IHXBuffer* pURL) PURE;
  2373. };
  2375. /****************************************************************************
  2376.  * 
  2377.  *  Interface:
  2378.  *
  2379.  * IHXRM2Converter2
  2380.  *
  2381.  *  Purpose:
  2382.  *
  2383.  * Interface to RM1->RM2 merge/converter module. This is a new improved
  2384.  *      interface which contains all of the functionality of the old one.
  2385.  *      However, this one is asynchronous where necessary and takes standard
  2386.  *      IHXFileObjects instead of pathnames for the required files.
  2387.  *
  2388.  *  IHXRM2Converter
  2389.  *
  2390.  * {00002F00-0901-11D1-8B06-00A024406D59}
  2391.  */
  2393. DEFINE_GUID(IID_IHXRM2Converter2, 0x00002F00, 0x901, 0x11d1, 0x8b, 
  2394.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  2396. #define CLSID_IRMARM2Converter2 IID_IHXRM2Converter2
  2398. #undef  INTERFACE
  2399. #define INTERFACE   IHXRM2Converter2
  2401. DECLARE_INTERFACE_(IHXRM2Converter2, IUnknown)
  2402. {
  2403.     /*
  2404.      * IUnknown methods
  2405.      */
  2406.     STDMETHOD(QueryInterface)     (THIS_
  2407.     REFIID riid,
  2408.     void** ppvObj) PURE;
  2409.     STDMETHOD_(ULONG32,AddRef)     (THIS) PURE;
  2410.     STDMETHOD_(ULONG32,Release)     (THIS) PURE;
  2412.     /*
  2413.      * IHXRM2Converter2 methods
  2414.      */
  2415.     STDMETHOD(Init)     (THIS_
  2416.     IHXRM2Converter2Response* pResponse) PURE;
  2417.     //
  2418.     // AddStream takes a stream from an RM1 file and
  2419.     // adds it to the new RM2 multirate section
  2420.     //
  2421.     STDMETHOD(AddStream)     (THIS_
  2422.     const char* pFilename,
  2423.     IHXFileObject* pFileObject,
  2424.     UINT16 nStreamNumber,
  2425.     BOOL bTagAsBackwardCompatible) PURE;
  2427.     //
  2428.     // AddInterleavedStream takes a stream from an
  2429.     // RM1 file and adds it to the initial interleaved
  2430.     // backward compatibility section
  2431.     //
  2432.     STDMETHOD(AddInterleavedStream) (THIS_
  2433.     const char* pFilename,
  2434.     IHXFileObject* pFileObject,
  2435.     UINT16 nStreamNumber) PURE;
  2437.     //
  2438.     // Add file slurps down all of the streams in
  2439.     // an RM1 file and adds them to the new RM2
  2440.     // multirate section.
  2441.     //
  2442.     STDMETHOD(AddFile)     (THIS_
  2443.     const char* pFilename,
  2444.     IHXFileObject* pFileObject) PURE;
  2446.     //
  2447.     // SetTitle,Author,Copyright, and Comment
  2448.     // should all be pretty self explanatory...
  2449.     //
  2450.     STDMETHOD(SetTitle)     (THIS_
  2451.     const char* pTitle) PURE;
  2452.     STDMETHOD(SetAuthor)     (THIS_
  2453.     const char* pAuthor) PURE;
  2454.     STDMETHOD(SetCopyright)     (THIS_
  2455.     const char* pCopyright) PURE;
  2456.     STDMETHOD(SetComment)     (THIS_
  2457.     const char* pComment) PURE;
  2459.     //
  2460.     // PairStreams lets you pair two different
  2461.     // streams together to play at a particular
  2462.     // bandwidth (i.e. the sum of the stream
  2463.     // bandwidths involved).
  2464.     //
  2465.     STDMETHOD(PairStreams)     (THIS_
  2466.     const char* pFilename1,
  2467.     UINT16 nStreamNumber1,
  2468.     const char* pFilename2,
  2469.     UINT16 nStreamNumber2) PURE;
  2471.     STDMETHOD(Merge) (THIS_
  2472. const char* pFilename,
  2473. IHXFileObject* pOutputFile,
  2474. UINT32 ulBytesToWrite) PURE;
  2476.     STDMETHOD(Reset)     (THIS) PURE;
  2477.     STDMETHOD(Done)     (THIS) PURE;
  2478. };
  2481. /****************************************************************************
  2482.  * 
  2483.  *  Interface:
  2484.  *
  2485.  * IHXRM2Converter2Response
  2486.  *
  2487.  *  Purpose:
  2488.  *
  2489.  * Response Interface for IHXRM2Converter2. 
  2490.  *
  2491.  *  IHXRM2Converter
  2492.  *
  2493.  * {00002F01-0901-11D1-8B06-00A024406D59}
  2494.  */
  2496. DEFINE_GUID(IID_IHXRM2Converter2Response, 0x00002F01, 0x901, 0x11d1, 0x8b, 
  2497.     0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  2500. #undef  INTERFACE
  2501. #define INTERFACE   IHXRM2Converter2Response
  2503. DECLARE_INTERFACE_(IHXRM2Converter2Response, IUnknown)
  2504. {
  2505.     /*
  2506.      * IUnknown methods
  2507.      */
  2508.     STDMETHOD(QueryInterface) (THIS_
  2509. REFIID riid,
  2510. void** ppvObj) PURE;
  2511.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2512.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2514.     /*
  2515.      * IHXRM2Converter2Response methods
  2516.      */
  2517.     STDMETHOD(InitDone) (THIS_
  2518. HX_RESULT status) PURE;
  2519.     STDMETHOD(AddStreamDone) (THIS_
  2520. HX_RESULT status) PURE;
  2521.     STDMETHOD(AddInterleavedStreamDone) (THIS_
  2522. HX_RESULT status) PURE;
  2523.     STDMETHOD(AddFileDone) (THIS_
  2524. HX_RESULT status) PURE;
  2525.     STDMETHOD(MergeDone) (THIS_
  2526. HX_RESULT status) PURE;
  2527. };
  2530. /****************************************************************************
  2531.  * 
  2532.  *  Interface:
  2533.  * 
  2534.  * IHXPoolPathAdjustment
  2535.  * 
  2536.  *  Purpose:
  2537.  * 
  2538.  * For file systems that use GetFileObjectFromPool to properly
  2539.  * adjust absolute local URLs so they will be accessed relative
  2540.  *      to the pool filesystem mountpoint.
  2541.  *
  2542.  *  IID_IHXPoolPathAdjustment:
  2543.  * 
  2544.  * {00002F02-0901-11d1-8b06-00A024406D59}
  2545.  * 
  2546.  */
  2547. DEFINE_GUID(IID_IHXPoolPathAdjustment, 0x00002F02, 0x901, 0x11d1, 0x8b, 0x6, 0x0, 0xa0, 0x24, 0x40, 0x6d, 0x59);
  2549. #undef  INTERFACE
  2550. #define INTERFACE   IHXPoolPathAdjustment
  2552. DECLARE_INTERFACE_(IHXPoolPathAdjustment, IUnknown)
  2553. {
  2554.     /*
  2555.      * IUnknown methods
  2556.      */
  2557.     STDMETHOD(QueryInterface) (THIS_
  2558. REFIID riid,
  2559. void** ppvObj) PURE;
  2561.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2563.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2565.     /*
  2566.      * IHXPoolPathAdjustment Methods.
  2567.      */
  2568.     STDMETHOD(AdjustAbsolutePath)   (THIS_
  2569.          IHXBuffer*      /*IN*/  pOldPath,
  2570.          REF(IHXBuffer*) /*OUT*/ pNewPath) PURE;
  2572. };
  2574. /*
  2575.  * Interface:
  2576.  *  IHXPostDataHandler
  2577.  *
  2578.  * Purpose:
  2579.  *
  2580.  *  Allows a file object to receive out of band POST data
  2581.  *      from an HTTP request.  If this interface is not implemented
  2582.  *      data will be placed in request header as "PostData"
  2583.  *
  2584.  *      When there is no more Data remaining, PostData will be
  2585.  *      called with a NULL argument.
  2586.  *
  2587.  * IID_IHXPostDataHandler:
  2588.  *
  2589.  * {0x0222a1b5-49fc-47e2-b69098befa0a588e}
  2590.  *
  2591.  */
  2592. DEFINE_GUID(IID_IHXPostDataHandler, 0x0222a1b5, 0x49fc, 0x47e2, 0xb6,
  2593. 0x90, 0x98, 0xbe, 0xfa, 0x0a, 0x58, 0x8e);
  2595. #undef INTERFACE
  2596. #define INTERFACE IHXPostDataHandler
  2598. DECLARE_INTERFACE_(IHXPostDataHandler, IUnknown)
  2599. {
  2600.     /*
  2601.      * IUnknownMethods
  2602.      */
  2604.     STDMETHOD(QueryInterface) (THIS_
  2605.     REFIID riid,
  2606.     void** ppvObj) PURE;
  2608.     STDMETHOD_(ULONG32,AddRef) (THIS) PURE;
  2610.     STDMETHOD_(ULONG32,Release) (THIS) PURE;
  2611.     /*
  2612.      * IHXPostDataHandler methods
  2613.      */
  2614.     STDMETHOD(PostData) (THIS_
  2615.          IHXBuffer* pBuf) PURE;
  2616. };
  2618. // $EndPrivate.
  2620. #endif  /* _HXFILES_H_ */