00001 /* ///////////////////////////////////////////////////////////////////////// 00002 * File: atlstl/util/module_scope.hpp 00003 * 00004 * Purpose: Scoping class for ATL _Module 00005 * 00006 * Created: 8th December 2004 00007 * Updated: 10th August 2009 00008 * 00009 * Home: http://stlsoft.org/ 00010 * 00011 * Copyright (c) 2004-2009, Matthew Wilson and Synesis Software 00012 * All rights reserved. 00013 * 00014 * Redistribution and use in source and binary forms, with or without 00015 * modification, are permitted provided that the following conditions are met: 00016 * 00017 * - Redistributions of source code must retain the above copyright notice, this 00018 * list of conditions and the following disclaimer. 00019 * - Redistributions in binary form must reproduce the above copyright notice, 00020 * this list of conditions and the following disclaimer in the documentation 00021 * and/or other materials provided with the distribution. 00022 * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of 00023 * any contributors may be used to endorse or promote products derived from 00024 * this software without specific prior written permission. 00025 * 00026 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 00027 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 00028 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 00029 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 00030 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 00031 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 00032 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 00033 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 00034 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 00035 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 00036 * POSSIBILITY OF SUCH DAMAGE. 00037 * 00038 * ////////////////////////////////////////////////////////////////////// */ 00039 00040 00047 #ifndef ATLSTL_INCL_ATLSTL_UTIL_HPP_MODULE_SCOPE 00048 #define ATLSTL_INCL_ATLSTL_UTIL_HPP_MODULE_SCOPE 00049 00050 #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION 00051 # define ATLSTL_VER_ATLSTL_UTIL_HPP_MODULE_SCOPE_MAJOR 2 00052 # define ATLSTL_VER_ATLSTL_UTIL_HPP_MODULE_SCOPE_MINOR 1 00053 # define ATLSTL_VER_ATLSTL_UTIL_HPP_MODULE_SCOPE_REVISION 1 00054 # define ATLSTL_VER_ATLSTL_UTIL_HPP_MODULE_SCOPE_EDIT 26 00055 #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */ 00056 00057 /* ///////////////////////////////////////////////////////////////////////// 00058 * Includes 00059 */ 00060 00061 #ifndef ATLSTL_INCL_ATLSTL_HPP_ATLSTL 00062 # include <atlstl/atlstl.hpp> 00063 #endif /* !ATLSTL_INCL_ATLSTL_HPP_ATLSTL */ 00064 #ifndef STLSOFT_INCL_STLSOFT_HPP_ERROR_EXCEPTIONS 00065 # include <stlsoft/error/exceptions.hpp> 00066 #endif /* !STLSOFT_INCL_STLSOFT_HPP_ERROR_EXCEPTIONS */ 00067 00068 /* ///////////////////////////////////////////////////////////////////////// 00069 * Namespace 00070 */ 00071 00072 #ifndef _ATLSTL_NO_NAMESPACE 00073 # if defined(_STLSOFT_NO_NAMESPACE) || \ 00074 defined(STLSOFT_DOCUMENTATION_SKIP_SECTION) 00075 /* There is no stlsoft namespace, so must define ::atlstl */ 00076 namespace atlstl 00077 { 00078 # else 00079 /* Define stlsoft::atlstl_project */ 00080 00081 namespace stlsoft 00082 { 00083 00084 namespace atlstl_project 00085 { 00086 00087 # endif /* _STLSOFT_NO_NAMESPACE */ 00088 #endif /* !_ATLSTL_NO_NAMESPACE */ 00089 00090 /* ///////////////////////////////////////////////////////////////////////// 00091 * Classes 00092 */ 00093 00098 // [[synesis:class:raii: atlstl::module_scope<T<M>, T<X>>]] 00099 template< ss_typename_param_k M 00100 , ss_typename_param_k X = stlsoft_ns_qual(null_exception_policy) 00101 > 00102 class module_scope 00103 { 00104 public: 00105 typedef M module_type; 00106 typedef X exception_policy_type; 00107 typedef module_scope<M, X> class_type; 00108 00111 public: 00112 module_scope(module_type &m, ATL::_ATL_OBJMAP_ENTRY *pObjMap, HINSTANCE hinst, GUID const* pLibID = NULL) 00113 : m_m(m) 00114 , m_hr(m.Init(pObjMap, hinst, pLibID)) 00115 { 00116 if(FAILED(m_hr)) 00117 { 00118 exception_policy_type xp; 00119 00120 xp(m_hr); 00121 } 00122 } 00123 ~module_scope() stlsoft_throw_0() 00124 { 00125 m_m.Term(); 00126 } 00128 00131 public: 00132 HRESULT hr() const throw() 00133 { 00134 return m_hr; 00135 } 00137 00138 // Members 00139 private: 00140 M &m_m; 00141 const HRESULT m_hr; 00142 }; 00143 00144 /* ////////////////////////////////////////////////////////////////////// */ 00145 00146 #ifndef _ATLSTL_NO_NAMESPACE 00147 # if defined(_STLSOFT_NO_NAMESPACE) || \ 00148 defined(STLSOFT_DOCUMENTATION_SKIP_SECTION) 00149 } // namespace atlstl 00150 # else 00151 } // namespace atlstl_project 00152 } // namespace stlsoft 00153 # endif /* _STLSOFT_NO_NAMESPACE */ 00154 #endif /* !_ATLSTL_NO_NAMESPACE */ 00155 00156 /* ////////////////////////////////////////////////////////////////////// */ 00157 00158 #endif /* !ATLSTL_INCL_ATLSTL_UTIL_HPP_MODULE_SCOPE */ 00159 00160 /* ///////////////////////////// end of file //////////////////////////// */