comcatregister.hpp

Visual C++下的界面设计

#ifndef __COM_CAT_REGISTER__
#define __COM_CAT_REGISTER__
///////////////////////////////////////////////////////////////////////////////
//
// File           : $Workfile:   ComCatRegister.hpp  $
// Version        : $Revision:   1.2  $
// Function       : 
//
// Author         : $Author:   len  $
// Date           : $Date:   Oct 25 1998 21:08:26  $
//
// Notes          : 
//
// Modifications  :
//
// $Log:   G:/Documents/JetByte/Source/JetByteTools/COMTools/PVCS/ComCatRegister.hpv  $
// 
//    Rev 1.2   Oct 25 1998 21:08:26   len
// 
//    Rev 1.1   Jun 06 1998 07:54:16   Len
// 
//    Rev 1.0   May 18 1998 07:34:42   Len
// Initial revision.
// 
///////////////////////////////////////////////////////////////////////////////
//
// Copyright 1998 JetByte Limited.
//
// JetByte Limited grants you ("Licensee") a non-exclusive, royalty free, 
// licence to use, modify and redistribute this software in source and binary 
// code form, provided that i) this copyright notice and licence appear on all 
// copies of the software; and ii) Licensee does not utilize the software in a 
// manner which is disparaging to JetByte Limited.
//
// This software is provided "AS IS," without a warranty of any kind. ALL
// EXPRESS OR IMPLIED CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING 
// ANY IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE 
// OR NON-INFRINGEMENT, ARE HEREBY EXCLUDED. JETBYTE LIMITED AND ITS LICENSORS 
// SHALL NOT BE LIABLE FOR ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF 
// USING, MODIFYING OR DISTRIBUTING THE SOFTWARE OR ITS DERIVATIVES. IN NO 
// EVENT WILL JETBYTE LIMITED BE LIABLE FOR ANY LOST REVENUE, PROFIT OR DATA, 
// OR FOR DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE 
// DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING 
// OUT OF THE USE OF OR INABILITY TO USE SOFTWARE, EVEN IF JETBYTE LIMITED 
// HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
//
// This software is not designed or intended for use in on-line control of
// aircraft, air traffic, aircraft navigation or aircraft communications; or in
// the design, construction, operation or maintenance of any nuclear
// facility. Licensee represents and warrants that it will not use or
// redistribute the Software for such purposes.
//
///////////////////////////////////////////////////////////////////////////////

#pragma warning(disable: 4201)   // nameless struct/union

#ifndef _WINDOWS_
#define WIN32_LEAN_AND_MEAN
#include <windows.h>
#undef WIN32_LEAN_AND_MEAN
#endif

#ifndef _INC_TCHAR
#include <tchar.h>
#endif

#ifndef __comcat_h__
#include <comcat.h>
#endif

#pragma warning(disable: 4201)

#ifndef __COM_USES_COM__
#include "ComUsesCom.hpp"
#endif

#ifndef __COM_EXCEPTION__
#include "ComException.hpp"
#endif

///////////////////////////////////////////////////////////////////////////////
// Namespace: JetByteTools
///////////////////////////////////////////////////////////////////////////////

namespace JetByteTools {
 
///////////////////////////////////////////////////////////////////////////////
// Classes defined in this file...
///////////////////////////////////////////////////////////////////////////////

class CComCatRegister;

///////////////////////////////////////////////////////////////////////////////
// Classes defined in other files...
///////////////////////////////////////////////////////////////////////////////

///////////////////////////////////////////////////////////////////////////////
// CComCatRegister
///////////////////////////////////////////////////////////////////////////////

class CComCatRegister : private CComUsesCom
{
   public :

      // Exceptions we might throw

      class Exception : public CComException
      {
         private :

            friend class CComCatRegister;

            Exception(LPCTSTR pWhere, HRESULT hr)
               :  CComException(pWhere, hr)
            {
            }
      };

      // Construction and destruction

      CComCatRegister();
      
      ~CComCatRegister();

      // Do stuff

      void RegisterCategory(
         REFCLSID rclsid, 
         LPCTSTR lpCatDesc,
         LCID lcid = GetUserDefaultLCID()) const;    

      void RegisterCategories(
         CATEGORYINFO *rgCategoryInfo, 
         ULONG cCategories = 1) const;

      void UnRegisterCategories(
         CATID *pCatid, 
         ULONG cCategories = 1) const;

      void RegisterClassImplCategories(
         REFCLSID rclsid, 
         CATID *pCatid, 
         ULONG cCategories = 1) const;

      void UnRegisterClassImplCategories(
         REFCLSID rclsid, 
         CATID *pCatid, 
         ULONG cCategories = 1) const;

      void RegisterClassReqCategories(
         REFCLSID rclsid, 
         CATID *pCatid, 
         ULONG cCategories = 1) const;

      void UnRegisterClassReqCategories(
         REFCLSID rclsid, 
         CATID *pCatid, 
         ULONG cCategories = 1) const;

   private :

      CComCatRegister(const CComCatRegister &rhs);
      CComCatRegister &operator=(const CComCatRegister &rhs);

      ICatRegister *m_pICatRegister;
};

///////////////////////////////////////////////////////////////////////////////
// Namespace: JetByteTools
///////////////////////////////////////////////////////////////////////////////

} // End of namespace JetByteTools 

#endif // __COM_CAT_REGISTER__

///////////////////////////////////////////////////////////////////////////////
// End of file
///////////////////////////////////////////////////////////////////////////////