This documentation is archived and is not being maintained.

_com_ptr_t::Attach

Microsoft Specific

Encapsulates a raw interface pointer of this smart pointer's type.


void Attach(
   Interface* pInterface 
) throw( );
void Attach(
   Interface* pInterface,
   bool fAddRef 
) throw( );

Parameters

pInterface

A raw interface pointer.

fAddRef

If it is true, then AddRef is called. If it is false, the _com_ptr_t object takes ownership of the raw interface pointer without calling AddRef.

  • Attach( pInterface )   AddRef is not called. The ownership of the interface is passed to this _com_ptr_t object. Release is called to decrement the reference count for the previously encapsulated pointer.

  • Attach( pInterface , fAddRef )   If fAddRef is true, AddRef is called to increment the reference count for the encapsulated interface pointer. If fAddRef is false, this _com_ptr_t object takes ownership of the raw interface pointer without calling AddRef. Release is called to decrement the reference count for the previously encapsulated pointer.

END Microsoft Specific

Show: