ComPtr-Klasse

Artikel
02/26/2013

Erstellt einen Typ des intelligenten Zeiger,, der die Schnittstelle darstellt, die durch den Vorlagenparameter angeben.ComPtr verwaltet automatisch einen Verweiszähler für den zugrunde liegenden Schnittstellenzeiger und gibt die Schnittstelle an, wenn der Verweiszähler auf Null an.

template <
   typename T
>
class ComPtr;

template<
   class U
>
friend class ComPtr;

Parameter

T
Die Schnittstelle, die das ComPtr darstellt.
U
Eine Klasse, auf die das aktuelle ComPtr friend ist.(Die Vorlage, die einen Parameter verwendet, wird geschützt).

Hinweise

ComPtr<> deklariert einen zugrunde liegenden Typ, der den Schnittstellenzeiger darstellt.Verwenden Sie ComPtr<>, um eine Variable zu deklarieren und den Pfeil Member ACCESS-Operator (->) zu verwenden, um eine Schnittstellenmember Funktion zuzugreifen.

Weitere Informationen zu den intelligenten Zeiger finden Sie im COM-intelligenter Unterabschnitt „Zeiger“ des COM Coding Practices Themas in der MSDN Library.

Mitglieder

Öffentliche Typedefs

Name	Beschreibung
InterfaceType	Ein Synonym für den Typ angegeben durch den T Vorlagenparameter.

Öffentliche Konstruktoren

Name	Beschreibung
ComPtr::ComPtr-Konstruktor	Intializes eine neue Instanz der ComPtr-Klasse.Überladungen ermöglichen, Standard, kopieren und verschieben konstruktoren Konvertierung.
ComPtr::~ComPtr-Destruktor	Deinitializes eine Instanz von ComPtr.

Öffentliche Methoden

Name	Beschreibung
ComPtr::As-Methode	Gibt ein ComPtr-Objekt zurück, das die Schnittstelle darstellt, die vom angegebenen Vorlagenparameter identifiziert wird.
ComPtr::AsIID-Methode	Gibt ein ComPtr-Objekt zurück, das die Schnittstelle darstellt, die sowohl durch die angegebene Schnittstelle ID identifizierten
ComPtr::AsWeak-Methode	Ruft einen schwachen Verweis auf das aktuelle Objekt ab.
ComPtr::Attach-Methode	Ordnet dieses ComPtr mit dem Schnittstellentyp zu, der durch den aktuellen Vorlagen Typparameter angegeben wird.
ComPtr::CopyTo-Methode	Kopiert die aktuelle oder die angegebene Schnittstelle, die diesem ComPtr dem angegebenen Zeiger Ausgabe zugeordnet sind.
ComPtr::Detach-Methode	Hebt die Zuordnung von der Schnittstelle ComPtr dies die sie darstellt.
ComPtr::Get-Methode	Ruft einen Zeiger auf die Schnittstelle ab, die diesem ComPtr zugeordnet ist.
ComPtr::GetAddressOf-Methode	Ruft die Adresse des ptr_ Datenmembers ab, der einen Zeiger auf eine Schnittstelle enthält, die von dieser ComPtr dargestellt wird.
ComPtr::ReleaseAndGetAddressOf-Methode	Gibt die Schnittstelle, die diesem ComPtr zugeordnet ist, und ruft dann die Adresse des ptr_ Datenmembers ab, der einen Zeiger auf eine Schnittstelle enthält, die freigegeben wurde.
ComPtr::Swap-Methode	Tauscht die Schnittstelle aus, die vom aktuellen ComPtr mit der Schnittstelle verwaltet wird, auf die vom angegebenen ComPtr verwaltet wird.

Geschützte Methoden

Name	Beschreibung
ComPtr::InternalAddRef-Methode	Erhöht den Verweiszähler der Schnittstelle, die mit diesem ComPtr zugeordnet ist.
ComPtr::InternalRelease-Methode	Führt eine COM-Befreiungsaktion für die Schnittstelle aus, die diesem ComPtr zugeordnet ist.

Öffentliche Operatoren

Name	Beschreibung
ComPtr::operator Microsoft::WRL::Details::BoolType-Operator	Gibt an, ob ein ComPtr der Objektlebensdauer einer Schnittstelle verwaltet.
ComPtr::operator&-Operator	Ruft die Adresse des aktuellen ComPtr ab.
ComPtr::operator=-Operator	Weist dem aktuellen ComPtr einen Wert zu.
ComPtr::operator->-Operator	Ruft einen Zeiger auf den Typ ab, der vom aktuellen Vorlagenparameter angeben.
ComPtr::operator==-Operator	Gibt an, ob zwei ComPtr-Objekte gleich sind.
ComPtr::operator!=-Operator	Gibt an, ob zwei ComPtr-Objekte ungleich sind.

Geschützte Datenmember

Name	Beschreibung
ComPtr::ptr_-Datenmember	Enthält einen Zeiger auf die Schnittstelle, der zugeordnet ist und von diesem verwaltet. ComPtr

Vererbungshierarchie

ComPtr

Anforderungen

Header: client.h

Namespace: Microsoft::WRL

Siehe auch

Referenz

Microsoft::WRL-Namespace

Freigeben über