_com_ptr_t-Klasse

Microsoft-spezifisch

Ein _com_ptr_t-Objekt kapselt einen COM-Schnittstellenzeiger und wird als "intelligenter" Zeiger bezeichnet. Diese Vorlagenklasse verwaltet die Ressourcenzuordnung und Die Zuordnung über Funktionsaufrufe an die IUnknown Memberfunktionen: QueryInterface, , AddRefund Release.

Auf einen intelligenten Zeiger wird in der Regel anhand der typedef-Definition verwiesen, die vom _COM_SMARTPTR_TYPEDEF-Makro bereitgestellt wird. Dieses Makro verwendet einen Schnittstellennamen und den IID und deklariert eine Spezialisierung von _com_ptr_t mit dem Namen der Schnittstelle plus einem Suffix von Ptr. Beispiel:

_COM_SMARTPTR_TYPEDEF(IMyInterface, __uuidof(IMyInterface));

deklariert die _com_ptr_t Spezialisierung IMyInterfacePtr.

Eine Reihe von Funktionsvorlagen, nicht Member dieser Vorlagenklasse, unterstützen Vergleiche mit einem intelligenten Zeiger auf der rechten Seite des Vergleichsoperators.

Bauwesen

Name	Beschreibung
_com_ptr_t	Erstellt ein _com_ptr_t-Objekt .

Vorgänge auf niedriger Stufe

Name	Beschreibung
Addref	Ruft die AddRef Memberfunktion des IUnknown gekapselten Schnittstellenzeigers auf.
Anfügen	Kapselt einen unformatierten Schnittstellenzeiger vom Typ dieses intelligenten Zeigers.
CreateInstance	Erstellt eine neue Instanz eines Objekts, das ein oder mehrere CLSIDProgIDObjekte enthält.
Trennen	Extrahiert den gekapselten Schnittstellenzeiger und gibt ihn zurück.
GetActiveObject	Fügt an eine vorhandene Instanz eines Objekts an, das einem oder mehreren CLSID Objekten zugeordnet ist ProgID.
GetInterfacePtr	Gibt den gekapselten Schnittstellenzeiger zurück.
QueryInterface	Ruft die QueryInterface Memberfunktion des IUnknown gekapselten Schnittstellenzeigers auf.
Release	Ruft die Release Memberfunktion des IUnknown gekapselten Schnittstellenzeigers auf.

Operatoren

Name	Beschreibung
operator =	Weist einem vorhandenen _com_ptr_t-Objekt einen neuen Wert zu.
Operatoren ==, !=, <, >= <, >=	Vergleichen Sie das smarte Zeigerobjekt mit einem anderen intelligenten Zeiger, einem unformatierten Schnittstellenzeiger oder NULL.
Extraktoren	Extrahieren Sie den gekapselten COM-Schnittstellenzeiger.

Ende Microsoft-spezifisch

Anforderungen

Header:<comip.h>

Lib: comsuppw.lib oder comsuppwd.lib (siehe /Zc:wchar_t (wchar_t Ist nativer Typ) für weitere Informationen)

Siehe auch

Compilerklassen für COM-Unterstützung