_com_ptr_t osztály

Microsoft-specifikus

Egy _com_ptr_t objektum egy COM-felület mutatóját foglalja magában, és "intelligens" mutatónak nevezik. Ez a sablonosztály az erőforrás-lefoglalást és a felszabadítást a IUnknown tagfüggvényekhez intézett függvényhívásokkal kezeli: QueryInterface, AddRefés Release.

Az intelligens mutatóra általában a _COM_SMARTPTR_TYPEDEF makró által biztosított typedef definíció hivatkozik. Ez a makró egy felületnevet és egy IID azonosítót vesz fel, és deklarálja a _com_ptr_t specializációját az interfész nevével és egy utótaggal Ptr. Például:

_COM_SMARTPTR_TYPEDEF(IMyInterface, __uuidof(IMyInterface));

deklarálja a _com_ptr_t specializációt IMyInterfacePtr.

A függvénysablonok készlete, nem a sablonosztály tagjai, támogatják az összehasonlítást egy intelligens mutatóval az összehasonlító operátor jobb oldalán.

Építés

Név	Leírás
_com_ptr_t	_com_ptr_t objektumot hoz létre.

Low-Level műveletek

Név	Leírás
AddRef	Meghívja a AddRef beágyazott felület mutatójának IUnknown tagfüggvényét.
Csatolás	Az intelligens mutató típusának nyers illesztőmutatóját foglalja magában.
CreateInstance	Új objektumpéldányt hoz létre egy adott CLSID vagy ProgID.
leválasztása	Kinyeri és visszaadja a beágyazott felület mutatóját.
GetActiveObject	Egy objektum meglévő példányához csatol egy vagy ProgIDtöbb objektumotCLSID.
GetInterfacePtr	A beágyazott felület mutatóját adja vissza.
QueryInterface	Meghívja a QueryInterface beágyazott felület mutatójának IUnknown tagfüggvényét.
Kiadás	Meghívja a Release beágyazott felület mutatójának IUnknown tagfüggvényét.

Működtetők

Név	Leírás
operátor =	Új értéket rendel egy meglévő _com_ptr_t objektumhoz.
operátorok ==, !=, <, >= <, >=	Hasonlítsa össze az intelligens mutató objektumot egy másik intelligens mutatóval, nyers felületi mutatóval vagy NULL értékkel.
Elszívók	Bontsa ki a beágyazott COM-felület mutatóját.

END Microsoft-specifikus kifejezés

Követelmények

Fejléc:<comip.h>

Lib: comsuppw.lib vagy comsuppwd.lib (további információ: /Zc:wchar_t (wchar_t Is Native Type)

Lásd még

A Compiler COM támogatási osztályai