Sdílet prostřednictvím


_com_ptr_t – třída

Specifické pro Microsoft

Objekt _com_ptr_t zapouzdřuje ukazatel rozhraní COM a nazývá se "inteligentní" ukazatel.Tato třída šablony spravuje přidělování a uvolňování prostředků prostřednictvím volání členských funkcí rozhraní IUnknown: QueryInterface, AddRef a Release.

Inteligentní ukazatel je obvykle odkazován definicí typedef poskytovanou makrem _COM_SMARTPTR_TYPEDEF.Toto makro přijímá název rozhraní a identifikátor IID a deklaruje specializaci objektu _com_ptr_t s názvem rozhraní a příponou Ptr.Příklad:

_COM_SMARTPTR_TYPEDEF(IMyInterface, __uuidof(IMyInterface));

deklaruje specializaci objektu _com_ptr_tIMyInterfacePtr.

Porovnání s inteligentním ukazatel na pravé straně porovnávacího operátoru podporuje sada šablon funkcí, nikoli členy této třídy šablony.

Konstrukce

_com_ptr_t

Sestavte objekt _com_ptr_t.

Operace nízké úrovně

AddRef

Zavolá členskou funkci AddRef rozhraní IUnknown pro zapouzdřený ukazatel rozhraní.

Připojit

Zapouzdří nezpracovaný ukazatel rozhraní typu tohoto inteligentního ukazatele.

CreateInstance

Vytvoří novou instanci objektu dle hodnot CLSID nebo ProgID.

Odpojit

Extrahuje a vrátí zapouzdřený ukazatel rozhraní.

GetActiveObject

Připojí se k existující instanci objektu dle hodnoty CLSID nebo ProgID.

GetInterfacePtr

Vrátí zapouzdřený ukazatel rozhraní.

QueryInterface

Zavolá členskou funkci QueryInterface rozhraní IUnknown pro zapouzdřený ukazatel rozhraní.

Verze

Zavolá členskou funkci Release rozhraní IUnknown pro zapouzdřený ukazatel rozhraní.

Operátory

operátor =

Přiřadí novou hodnotu existujícímu objektu _com_ptr_t.

operátory ==, !=, <, >, <=, >=

Porovná objekt inteligentního ukazatele s jiným inteligentním ukazatelem, nezpracovaným ukazatelem rozhraní nebo hodnotou NULL.

Extraktory

Extrahuje zapouzdřený ukazatel rozhraní COM.

Požadavky

Soubor hlaviček: comip.h

Lib: comsuppw.lib nebo comsuppwd.lib (další informace viz /Zc:wchar_t (wchar_t je nativní typ))

Viz také

Referenční dokumentace

Třídy podpory kompilátoru modelu COM