Macros de mapa do COM

  • Artigo

Essas macros definem mapas de interface do COM.

Macro Descrição
BEGIN_COM_MAP Marca o início das entradas de mapa da interface do COM.
END_COM_MAP Marca o final das entradas de mapa da interface do COM.

Requisitos

Cabeçalho: atlcom.h

BEGIN_COM_MAP

O mapa do COM é o mecanismo que expõe interfaces em um objeto para um cliente por meio de QueryInterface.

BEGIN_COM_MAP(x)

Parâmetros

x
[entrada] O nome do objeto de classe no qual você está expondo interfaces.

Comentários

CComObjectRootEx::InternalQueryInterface retorna apenas ponteiros para interfaces no mapa do COM. Inicie seu mapa de interface com a macro BEGIN_COM_MAP, adicione entradas para cada uma de suas interfaces com a macro COM_INTERFACE_ENTRY ou uma de suas variantes e conclua o mapa com a macro END_COM_MAP.

Exemplo

No exemplo BEEPER da ATL:

BEGIN_COM_MAP(CBeeper)
   COM_INTERFACE_ENTRY(IBeeper)
   COM_INTERFACE_ENTRY(IDispatch)
   COM_INTERFACE_ENTRY_TEAR_OFF(IID_ISupportErrorInfo, CBeeper2)
END_COM_MAP()

END_COM_MAP

Termina a definição do mapa da interface do COM.

END_COM_MAP()

Confira também

Macros
Funções globais de mapa COM