ATL::CComPtr< T > Class Template Reference

#include <atlcomcli.h>

Inheritance diagram for ATL::CComPtr< T >:

Public Member Functions
	CComPtr ()
	CComPtr (T *lp)
	CComPtr (const CComPtr< T > &lp)
	~CComPtr ()
HRESULT	CoCreateInstance (REFCLSID rclsid, REFIID riid, LPUNKNOWN pOuter=NULL, DWORD ClsCtx=CLSCTX_ALL)
HRESULT	CoCreateInstance (LPCOLESTR ProgID, REFIID riid, LPUNKNOWN pOuter=NULL, DWORD ClsCtx=CLSCTX_ALL)
T *	operator= (T *lp)
T *	operator= (const CComPtr< T > &lp)
void	Release ()
void	Attach (T *lp)
T *	Detach ()
T **	operator& ()
	operator T* ()
_NoAddRefReleaseOnCComPtr< T > *	operator-> () const

Public Attributes
T *	p

Detailed Description

template<class T>
class ATL::CComPtr< T >

Definition at line 71 of file atlcomcli.h.

Constructor & Destructor Documentation

CComPtr() [1/3]

template<class T >

ATL::CComPtr< T >::CComPtr ( )

inline

Definition at line 76 of file atlcomcli.h.

    {
        p = NULL;
    }

CComPtr() [2/3]

template<class T >

ATL::CComPtr< T >::CComPtr ( T *  lp )

inline

Definition at line 81 of file atlcomcli.h.

    {
        p = lp;
        if (p != NULL)
            p->AddRef();
    }

CComPtr() [3/3]

template<class T >

ATL::CComPtr< T >::CComPtr ( const CComPtr< T > &  lp )

inline

Definition at line 88 of file atlcomcli.h.

    {
        p = lp.p;
        if (p != NULL)
            p->AddRef();
    }

~CComPtr()

template<class T >

ATL::CComPtr< T >::~CComPtr ( )

inline

Definition at line 95 of file atlcomcli.h.

    {
        if (p != NULL)
            p->Release();
    }

Member Function Documentation

Attach()

template<class T >

void ATL::CComPtr< T >::Attach ( T *  lp )

inline

Definition at line 179 of file atlcomcli.h.

    {
        if (p != NULL)
            p->Release();
        p = lp;
    }

Referenced by CDesktopUpgradePropertyBag::_GetOldDesktopViewStream(), CDesktopUpgradePropertyBag::_NewStreamFromOld(), CDesktopUpgradePropertyBag::_ReadItemPositions(), _ShowPropertiesDialogThread(), CInternetToolbar::InitNew(), and CACListISF::SetLocation().

CoCreateInstance() [1/2]

template<class T >

HRESULT ATL::CComPtr< T >::CoCreateInstance ( LPCOLESTR  ProgID, REFIID  riid, LPUNKNOWN  pOuter = NULL, DWORD  ClsCtx = CLSCTX_ALL  )

inline

Definition at line 107 of file atlcomcli.h.

    {
        CLSID clsid;
        HRESULT hr = CLSIDFromProgID(ProgID, &clsid);
        return FAILED(hr) ? hr : CoCreateInstance(clsid, riid, pOuter, ClsCtx);
    }

CoCreateInstance() [2/2]

template<class T >

HRESULT ATL::CComPtr< T >::CoCreateInstance ( REFCLSID  rclsid, REFIID  riid, LPUNKNOWN  pOuter = NULL, DWORD  ClsCtx = CLSCTX_ALL  )

inline

Definition at line 101 of file atlcomcli.h.

    {
        ATLASSERT(!p);
        return ::CoCreateInstance(rclsid, pOuter, ClsCtx, riid, (void**)&p);
    }

Referenced by ATL::CComPtr< T >::CoCreateInstance().

Detach()

template<class T >

T * ATL::CComPtr< T >::Detach ( )

inline

Definition at line 186 of file atlcomcli.h.

    {
        T *saveP;
 
        saveP = p;
        p = NULL;
        return saveP;
    }

Referenced by CDesktopUpgradePropertyBag::_GetOldDesktopViewStream(), CDesktopUpgradePropertyBag::_NewStreamFromOld(), BrFolder_GetChildrenEnum(), CInternetToolbar::CreateMenuBar(), CreateStartMenu(), CNetConnectionPropertyUi::EnumComponents(), GetFavoritesFolder(), CNetConnectionPropertyUi::GetINetCfgComponent(), IFileSystemBindData_Constructor(), ILGetConnection(), InitIconOverlays(), CInternetToolbar::InitNew(), CDefView::SetCallback(), CACListISF::SetLocation(), SHCreateShellFolderView(), and SHCreateShellItem().

operator T*()

template<class T >

ATL::CComPtr< T >::operator T* ( )

inline

Definition at line 201 of file atlcomcli.h.

    {
        return p;
    }

operator&()

template<class T >

T ** ATL::CComPtr< T >::operator& ( )

inline

Definition at line 195 of file atlcomcli.h.

    {
        ATLASSERT(p == NULL);
        return &p;
    }

operator->()

template<class T >

_NoAddRefReleaseOnCComPtr< T > * ATL::CComPtr< T >::operator-> ( ) const

inline

Definition at line 206 of file atlcomcli.h.

    {
        ATLASSERT(p != NULL);
        return (_NoAddRefReleaseOnCComPtr<T> *)p;
    }

operator=() [1/2]

template<class T >

T * ATL::CComPtr< T >::operator= ( const CComPtr< T > &  lp )

inline

Definition at line 128 of file atlcomcli.h.

    {
        T* pOld = p;
 
        p = lp.p;
        if (p != NULL)
            p->AddRef();
 
        if (pOld != NULL)
            pOld->Release();
 
        return *this;
    }

operator=() [2/2]

template<class T >

T * ATL::CComPtr< T >::operator= ( T *  lp )

inline

Definition at line 114 of file atlcomcli.h.

    {
        T* pOld = p;
 
        p = lp;
        if (p != NULL)
            p->AddRef();
 
        if (pOld != NULL)
            pOld->Release();
 
        return *this;
    }

Release()

template<class T >

void ATL::CComPtr< T >::Release ( )

inline

Definition at line 170 of file atlcomcli.h.

    {
        if (p != NULL)
        {
            p->Release();
            p = NULL;
        }
    }

Referenced by CDesktopUpgradePropertyBag::_GetOldDesktopViewStream(), CShellBrowser::BrowseToPath(), CAddressBand::CloseDW(), CToolsBand::CloseDW(), CMenuBand::CloseDW(), CDefView::DestroyViewWindow(), CDefView::drag_notify_subitem(), CSendToZip::DragLeave(), CDefView::DragLeave(), CShellLink::DragLeave(), CDefView::Drop(), ExplorerMessageLoop(), CDefView::FillFileMenu(), GetFavoritesFolder(), CLanStatus::InitializeNetTaskbarNotifications(), CDefView::InvokeContextMenuCommand(), CSendToMenu::LoadAllItems(), CShellBrowser::OnDestroy(), CDefView::OnNotify(), CTrayWindow::OnSettingChanged(), CTrayWindowCtxMenu::QueryContextMenu(), CACListISF::SetLocation(), CAddressBand::SetSite(), CBrandBand::SetSite(), CInternetToolbar::SetSite(), CToolsBand::SetSite(), test_IACLCustomMRU_Continue(), test_IACLCustomMRU_UpdateOrder(), CShellBrowser::UpdateForwardBackState(), CShellBrowser::UpdateGotoMenu(), CShellBrowser::WindowProc(), and MenuCleanup::~MenuCleanup().

Member Data Documentation

p

template<class T >

T* ATL::CComPtr< T >::p

Definition at line 74 of file atlcomcli.h.

Referenced by CMergedFolder::AddNameSpace(), ATL::CComPtr< T >::CComPtr(), ATL::CComPtr< T >::Detach(), CDefView::drag_notify_subitem(), CMenuSFToolbar::FillToolbar(), CDefView::GetAdvise(), CShellBrowser::GetBaseBar(), CBaseBar::GetClient(), CDockSite::GetContainedBand(), CBrandBand::GetSite(), CInternetToolbar::GetSite(), CBaseBar::GetSite(), CShellBrowser::GetTravelLog(), HasClipboardData(), CBandProxy::IsConnected(), CDefView::IsDropOnSource(), CToolbarProxy::OnAddBitmap(), CDefView::OnDefaultCommand(), CToolbarProxy::OnForwardMessage(), CDefView::OnGetShellBrowser(), CSearchBar::OnInitDialog(), CBaseBar::OnNotify(), CDefView::OnStateChange(), CBaseBarSite::OnWinEvent(), ATL::CComPtr< CFindFolder >::operator CFindFolder *(), ATL::CComPtr< T >::operator&(), ATL::CComPtr< T >::operator->(), ATL::CComPtr< T >::operator=(), ATL::CComQIIDPtr< T, piid >::operator=(), CShellBrowser::QueryActiveShellView(), CShellBrowser::QueryStatus(), CShellBrowser::SaveHistory(), SHBindToFolder(), CShellBrowser::ShowBand(), CShellBrowser::WindowProc(), and CDesktopBrowser::~CDesktopBrowser().

---

The documentation for this class was generated from the following file:

• sdk/lib/atl/atlcomcli.h