Skip to content

com-ptr-t-extractors.md

Latest commit

 

History

History
91 lines (78 loc) · 2.56 KB

com-ptr-t-extractors.md

File metadata and controls

91 lines (78 loc) · 2.56 KB
title _com_ptr_t Extractors | Microsoft Docs
ms.custom
ms.date 11/04/2016
ms.reviewer
ms.suite
ms.technology
cpp-language
ms.tgt_pltfrm
ms.topic language-reference
f1_keywords
_com_ptr_t::operatorInterface&
operatorInterface*
operatorInterface&
_com_ptr_t::operatorbool
_com_ptr_t.operator->
_com_ptr_t.operator*
_com_ptr_t::operator->
_com_ptr_t::operator*
_com_ptr_t.operatorInterface&
_com_ptr_t.operatorbool
dev_langs
C++
helpviewer_keywords
operator Interface&
* operator, with specific objects
operator&
operator*
-> operator, with specific objects
& operator, with specific objects
operator Interface*
operator *
operator->
operator bool
extractors, _com_ptr_t class
extractors
ms.assetid 194b9e0e-123c-49ff-a187-0a7fcd68145a
caps.latest.revision 6
author mikeblome
ms.author mblome
manager ghogen
translation.priority.ht
cs-cz
de-de
es-es
fr-fr
it-it
ja-jp
ko-kr
pl-pl
pt-br
ru-ru
tr-tr
zh-cn
zh-tw

_com_ptr_t Extractors

Microsoft Specific

Extract the encapsulated COM interface pointer.

Syntax

  
      operator Interface*( ) const throw( );   
operator Interface&( ) const;   
Interface& operator*( ) const;   
Interface* operator->( ) const;   
Interface** operator&( ) throw( );   
operator bool( ) const throw( );

Remarks

  • operator Interface* Returns the encapsulated interface pointer, which may be NULL.

  • operator Interface& Returns a reference to the encapsulated interface pointer, and issues an error if the pointer is NULL.

  • operator* Allows a smart pointer object to act as though it were the actual encapsulated interface when dereferenced.

  • operator-> Allows a smart pointer object to act as though it were the actual encapsulated interface when dereferenced.

  • operator& Releases any encapsulated interface pointer, replacing it with NULL, and returns the address of the encapsulated pointer. This allows the smart pointer to be passed by address to a function that has an out parameter through which it returns an interface pointer.

  • operator bool Allows a smart pointer object to be used in a conditional expression. This operator returns true if the pointer is not NULL.

END Microsoft Specific

See Also

_com_ptr_t Class