_com_ptr_t::Attach
Microsoft Specific
Encapsulates a raw interface pointer of this smart pointer's type.
Syntax
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
.
Remarks
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 isfalse
, this_com_ptr_t
object takes ownership of the raw interface pointer without callingAddRef
.Release
is called to decrement the reference count for the previously encapsulated pointer.
END Microsoft Specific
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for