Třída CComPtr

Článek
06/09/2015

Inteligentní ukazatel třída ukazatele rozhraní COM správy.

template< 
   class T  
> 
class CComPtr

Parametry

T
Rozhraní COM určující typ ukazatele uloženy.

Členy

Veřejné konstruktory

Název	Description
CComPtr::CComPtr	Konstruktor.

Veřejné operátory

Název	Description
CComPtr::operator =	Přiřadí ukazatel ukazatel člena.

Poznámky

Používá ATL CComPtr a CComQIPtr spravovat ukazatele rozhraní COM.Obě jsou odvozeny z CComPtrBase, a jak provádět odkaz Automatické počítání.

CComPtr a CComQIPtr třídy mohou pomoci odstranit provedením počítání odkazů automatické nevrácené paměti.Následující funkce obou provádět logickou operací; však jak druhé verze může být méně náchylný CComPtr třídy:

// Error-checking routine that performs manual lifetime management 
// of a COM IErrorInfo object
HRESULT CheckComError_Manual()
{
   HRESULT hr;
   CComBSTR bstrDescription; 
   CComBSTR bstrSource; 
   CComBSTR bstrHelpFile; 

   IErrorInfo* pErrInfo = NULL; // naked COM interface pointer
   hr = ::GetErrorInfo(0, &pErrInfo);
   if(hr != S_OK)
      return hr;

   hr = pErrInfo->GetDescription(&bstrDescription); 
   if(FAILED(hr))
   {
      pErrInfo->Release();   // must release interface pointer before returning 
      return hr;
   }

   hr = pErrInfo->GetSource(&bstrSource);
   if(FAILED(hr))
   {
      pErrInfo->Release();   // must release interface pointer before returning 
      return hr;
   }

   hr = pErrInfo->GetHelpFile(&bstrHelpFile);
   if(FAILED(hr))
   {
      pErrInfo->Release();   // must release interface pointer before returning 
      return hr;
   }

   pErrInfo->Release();      // must release interface pointer before returning 
   return S_OK;
}

// Error-checking routine that performs automatic lifetime management 
// of a COM IErrorInfo object through a CComPtr smart pointer object
HRESULT CheckComError_SmartPtr()
{
   HRESULT hr;
   CComBSTR bstrDescription; 
   CComBSTR bstrSource; 
   CComBSTR bstrHelpFile; 

   CComPtr<IErrorInfo> pErrInfo; 
   hr = ::GetErrorInfo(0, &pErrInfo);
   if(hr != S_OK)
      return hr;

   hr = pErrInfo->GetDescription(&bstrDescription); 
   if(FAILED(hr))
      return hr;

   hr = pErrInfo->GetSource(&bstrSource);
   if(FAILED(hr))
      return hr;

   hr = pErrInfo->GetHelpFile(&bstrHelpFile);
   if(FAILED(hr))
      return hr;

   return S_OK;
}   // CComPtr will auto-release underlying IErrorInfo interface pointer as needed

V sestavení ladicí propojte atlsd.lib kód sledování.

Hierarchii dědičnosti

CComPtrBase

CComPtr

Požadavky

Záhlaví: atlbase.h

Viz také

Referenční dokumentace

CComPtr::CComPtr

CComQIPtr::CComQIPtr

Další zdroje

Přehled třídy ATL

Sdílet prostřednictvím