Referência alfabética de macros de ATL

Em esta seção, os tópicos de referência para macros de ATL são organizados em ordem alfabética. Para localizar uma macro específica por categoria, consulte macros de ATL.

Macro	Descrição
_ATL_ALL_WARNINGS	Um símbolo que poderia erros em projetos converteu-se de versões anteriores de ATL.
_ATL_APARTMENT_THREADED	Defina se um ou mais dos seus objetos usam o Apartment threads.
_ATL_CSTRING_EXPLICIT_CONSTRUCTORS	Faz determinados construtores de CString explícitas, evitando todas as conversões involuntárias.
_ATL_DEBUG_INTERFACES	Defina este macro antes de incluir qualquer arquivo de cabeçalho de ATL para rastrear qualquer AddRef e Versão chama interfaces dos seus componentes para a janela de saída.
_ATL_DEBUG_QI	Grava todas as chamadas a QueryInterface para a janela de saída.
_ATL_FREE_THREADED	Defina se um ou mais de uso de objetos de segmentação livre ou neutra.
_ATL_MIXED	Informa o compilador que seu aplicativo de ATL é composto de ambos e de compilands de /clr .
_ATL_MULTI_THREADED	Um símbolo que indica o projeto terá os objetos que são marcados como ambos, livre ou neutro. _ATL_FREE_THREADED Macro deve ser usado no novo código.
_ATL_NO_COM_SUPPORT	Um símbolo que impede o código COM- relacionado é compilado com seu projeto.
_ATL_NO_AUTOMATIC_NAMESPACE	Um símbolo que evitar o uso padrão do namespace como ATL.
_ATL_NO_VARIANT_THROW	Suprime Classe de CComVariant de exceções.
_ATL_SECURE_NO_WARNINGS	Impede avisos do compilador para o uso de funções substituídos de ATL.
_ATL_STATIC_REGISTRY	Indica um símbolo que você deseja que o código do registro para seu objeto está no objeto para evitar uma dependência em ATL.DLL.
_ATLCATCH	Instruções para manipular erros que ocorrem em _ATLTRYassociado
_ATLCATCHALL	Instruções para manipular erros que ocorrem em _ATLTRY associado.
_ATLTRY	Marca guardada uma seção de código onde um erro pode ocorrer possivelmente.
Sinalizadores de ATL_ESC	Esses sinalizadores são usados para controlar o comportamento de EscapeXML.
ALT_MSG_MAP	Marca o início de um mapa alternativo de mensagem.
Macros de conversão de cadeia de caracteres de ATL e de MFC	Macros de conversão de cadeia de caracteres válidos para ATL e MFC.
ATLASSERT	A macro de ATLASSERT executa a mesma funcionalidade que a macro de _ASSERTE encontrado na biblioteca em tempo de execução de C.
ATL_NOINLINE	Um símbolo que indica uma função não deve ser inlined.
ATL_NO_VTABLE	Um símbolo que impede o ponteiro vtable é inicializado no construtor e o destrutor da classe.
Sinalizadores de ATL_URL	Esses sinalizadores alteram o comportamento de AtlEscapeUrl e de AtlCanonicalizeUrl.
ATL_URL_SCHEME	Os membros da enumeração fornecem constantes para esquemas compreendidos por Som tipo wave.
ATL_WORKER_THREAD_WAIT	Este macro define o valor padrão em milissegundos que CWorkerThread::Shutdown esperará o thread de trabalho para fechar.
ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT	Este macro define o horário padrão em milissegundos que CThreadPool esperará um segmento para fechar.
ATLS_DEFAULT_THREADSPERPROC	Este padrão macro define o número de segmentos pelo processador usado por CThreadPool.
Sinalizadores de ATLSMTP_QPENCODE	Esses sinalizadores descrevem como a codificação citar- imprimível deve ser executada por QPEncode.
Sinalizadores de ATLSMTP_UUENCODE	Esses sinalizadores descrevem como uuencoding deve ser executado por uuencode.
ATLTRACE	Relata avisos para um dispositivo de saída, como a janela do depurador, de acordo com os sinalizadores e níveis indicados. Incluído para compatibilidade com versões anteriores.
ATLTRACE2	Relata avisos para um dispositivo de saída, como a janela do depurador, de acordo com os sinalizadores e níveis indicados.
ATLTRACENOTIMPL	Em compilações de depuração de ATL, envia a cadeia de caracteres “funcname não são implementados” para o dispositivo de despejo e retornam E_NOTIMPL.
BEGIN_CATEGORY_MAP	Marca o início do mapa de categoria.
BEGIN_COM_MAP	O mapa COM é o mecanismo que expõe interfaces em um objeto para um cliente com QueryInterface.
BEGIN_CONNECTION_POINT_MAP	Marca o início de entradas de mapeamento de ponto de conexão.
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP	Marca o início do mapa da classe de dados de extensão do snap-in.
BEGIN_MSG_MAP	Marca o início do mapa padrão de mensagem.
BEGIN_PROP_MAP	Marca o início do mapa da propriedade do objeto.
BEGIN_RDX_MAP	Marca o início do mapa de troca de dados do Registro.
BEGIN_SERVICE_MAP	Marca o início do mapa de serviço.
BEGIN_SINK_MAP	Declara o início do mapa do coletor de eventos para o controle composto.
BEGIN_SNAPINTOOLBARID_MAP	Declara o início do mapa de identificação da barra de ferramentas para o snap-in do objeto.
CHAIN_MSG_MAP	Define uma entrada em um mapa de mensagem.
CHAIN_MSG_MAP_ALT	Define uma entrada em um mapa de mensagem.
CHAIN_MSG_MAP_ALT_MEMBER	Define uma entrada em um mapa de mensagem.
CHAIN_MSG_MAP_DYNAMIC	Define uma entrada em um mapa de mensagem.
CHAIN_MSG_MAP_MEMBER	Define uma entrada em um mapa de mensagem.
Macros de COM_INTERFACE_ENTRY	Esses macros insira as interfaces de um objeto no seu mapa COM para que eles possam ser acessados por QueryInterface.
COM_INTERFACE_ENTRY	Insere interfaces no mapa da interface COM.
COM_INTERFACE_ENTRY2	Use este macro para desambiguar duas ramificações de herança.
COM_INTERFACE_ENTRY2_IID	Mesmo que COM_INTERFACE_ENTRY2, a não ser que você pode especificar um IID diferente.
COM_INTERFACE_ENTRY_AGGREGATE	Quando a interface identificada por iid é consultada para, COM_INTERFACE_ENTRY_AGGREGATE encaminha a punk.
COM_INTERFACE_ENTRY_AGGREGATE_BLIND	Mesmo que COM_INTERFACE_ENTRY_AGGREGATE, exceto que consulte para qualquer IID leva a encaminhar a consulta a punk.
COM_INTERFACE_ENTRY_AUTOAGGREGATE	Mesmo que COM_INTERFACE_ENTRY_AGGREGATE, exceto se punk é NULO, cria automaticamente a agregação descrita por clsid.
COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND	Mesmo que COM_INTERFACE_ENTRY_AUTOAGGREGATE, exceto que consulte para qualquer IID leva a encaminhar a consulta a punk, e se punk é NULO, criando automaticamente a agregação descrita por clsid.
COM_INTERFACE_ENTRY_BREAK	Faz com que seu programa chama DebugBreak quando a interface especificada é consultada para.
COM_INTERFACE_ENTRY_CACHED_TEAR_OFF	Salva os dados - específicos para cada instância.
COM_INTERFACE_ENTRY_CHAIN	Processa o mapa da classe base quando o processamento atinge essa entrada no mapa COM.
COM_INTERFACE_ENTRY_FUNC	Um mecanismo geral para ligar em QueryInterface de ATL lógica.
COM_INTERFACE_ENTRY_FUNC_BLIND	Mesmo que COM_INTERFACE_ENTRY_FUNC, exceto que consulte para alguns resultados de IID em uma chamada para func.
COM_INTERFACE_ENTRY_IID	Use este macro para incorporar a interface no mapa COM e para especificar o IID.
COM_INTERFACE_ENTRY_NOINTERFACE	Retorna E_NOINTERFACE e encerra o processamento do mapa da quando a interface especificada é consultada para.
COM_INTERFACE_ENTRY_TEAR_OFF	Expõem suas interfaces de rasgo - fora.
COMMAND_CODE_HANDLER	Semelhante a COMMAND_HANDLER, mas mapeia uma mensagem de WM_COMMAND baseada somente no código de notificação.
COMMAND_HANDLER	Define uma entrada em um mapa de mensagem.
COMMAND_ID_HANDLER	Semelhante a COMMAND_HANDLER, mas mapeia uma mensagem de WM_COMMAND baseada somente no identificador do item de menu, do controle, ou de aceleração.
COMMAND_RANGE_CODE_HANDLER	Semelhante a COMMAND_RANGE_HANDLER, mas às mensagens de WM_COMMAND de mapas com um código específico de notificação de um intervalo dos controles a um único manipulador funciona.
COMMAND_RANGE_HANDLER	Semelhante a COMMAND_HANDLER, mas às mensagens de WM_COMMAND de mapas de um intervalo dos controles a um único manipulador funciona.
CONNECTION_POINT_ENTRY	Insere um ponto de conexão para a interface especificada no mapa de ponto de conexão para que possa ser acessado.
DECLARE_AGGREGATABLE	Especifica que o objeto pode ser agregado.
DECLARE_CLASSFACTORY	Declara CComClassFactory para ser o factory da classe.
DECLARE_CLASSFACTORY2	Declara CComClassFactory2 para ser o factory da classe.
DECLARE_CLASSFACTORY_AUTO_THREAD	Declara CComClassFactoryAutoThread para ser o factory da classe.
DECLARE_CLASSFACTORY_EX	Declara cf para ser o factory da classe.
DECLARE_CLASSFACTORY_SINGLETON	Declara CComClassFactorySingleton para ser o factory da classe.
DECLARE_EMPTY_MSG_MAP	Declara um mapa de mensagem vazia.
DECLARE_GET_CONTROLLING_UNKNOWN	Declara uma função virtual GetControllingUnknown.
DECLARE_LIBID	Fornece uma maneira para que ATL obtenha o libid de biblioteca de tipo.
DECLARE_NO_REGISTRY	Use DECLARE_NO_REGISTRY se você desejar evitar qualquer registro de opção ATL para a classe na qual o macro aparece.
DECLARE_NOT_AGGREGATABLE	Especifica que o objeto não pode ser agregado.
DECLARE_OBJECT_DESCRIPTION	Permite que você especifique uma descrição de texto para seu objeto da classe.
DECLARE_OLEMISC_STATUS	Usado em controles de ATL ActiveX para definir os sinalizadores de OLEMISC.
DECLARE_ONLY_AGGREGATABLE	Especifica que o objeto deve ser agregado.
DECLARE_POLY_AGGREGATABLE	Especifica que uma instância de CComPolyObject < x > é criada quando o objeto é criado.
DECLARE_PROTECT_FINAL_CONSTRUCT	Proteja o objeto ser excluído (durante FinalConstruct) se o objeto agregado interno incrementa contagem de referência diminui a contagem a 0.
DECLARE_REGISTRY	Inserir o registro padrão da classe no Registro do sistema ou remova-o de Registro do sistema.
DECLARE_REGISTRY_APPID_RESOURCEID	Especifica as informações necessárias para registrar automaticamente o appid.
DECLARE_REGISTRY_RESOURCE	Obtém o recurso chamado que contém o arquivo do Registro e executa o script a incorporam objetos no Registro do sistema ou remova-os de Registro do sistema.
DECLARE_REGISTRY_RESOURCEID	Mesmo que DECLARE_REGISTRY_RESOURCE exceto que ela usa uma UINT gerado para identificar o recurso, em vez de um nome de cadeia de caracteres.
DECLARE_VIEW_STATUS	Coloque esse macro em uma classe de controle de controle de ATL ActiveX para especificar os sinalizadores de VIEWSTATUS para o contêiner.
DECLARE_WND_CLASS	Permite que você especifique o nome de uma classe de nova janela. Coloque esse macro em uma classe de controle de controle de ATL ActiveX.
DECLARE_WND_CLASS_EX	Permite que você especifique o nome de uma classe existente da janela até que uma classe de nova janela será base. Coloque esse macro em uma classe de controle de controle de ATL ActiveX.
DECLARE_WND_SUPERCLASS	Permite que você especifique os parâmetros de uma classe. Coloque esse macro em uma classe de controle de controle de ATL ActiveX.
DEFAULT_REFLECTION_HANDLER	Fornece um manipulador padrão para a janela filho (o controle) que irá receber mensagens; refletidas o tratador corretamente irá transmitir mensagens não tratados a DefWindowProc.
Macros de conversão de cadeia de caracteres de DEVMODE e de TEXTMETRIC	Esses macros criar uma cópia de uma estrutura de DEVMODE ou de TEXTMETRIC e convertem as cadeias de caracteres dentro da nova estrutura para um novo tipo cadeia de caracteres.
END_CATEGORY_MAP	A marca final do mapa de categoria.
END_COM_MAP	Termina a definição do mapa da interface COM.
END_CONNECTION_POINT_MAP	Marca end de entradas de mapeamento de ponto de conexão.
END_EXTENSION_SNAPIN_NODEINFO_MAP	A marca final do mapa da classe de dados de extensão do snap-in.
END_MSG_MAP	A marca final de um mapa de mensagem.
END_PROP_MAP	A marca final do mapa da propriedade do objeto.
END_RDX_MAP	A marca final do mapa de troca de dados do Registro.
END_SERVICE_MAP	A marca final do mapa de serviço.
END_SINK_MAP	Declara o final do mapa do coletor de eventos para o controle composto.
END_SNAPINTOOLBARID_MAP	Declara o final do mapa de identificação da barra de ferramentas para o snap-in do objeto.
EXTENSION_SNAPIN_DATACLASS	Adiciona um membro de dados para a classe de dados para ISnapInItemImpl- classe derivada de extensão do snap-in.
EXTENSION_SNAPIN_NODEINFO_ENTRY	Adiciona uma classe de dados de extensão do snap-in no mapa da classe de dados de extensão do snap-in.
FORWARD_NOTIFICATIONS	Encaminha notificações para a janela pai.
IMPLEMENTED_CATEGORY	Adicione uma macro de IMPLEMENTED_CATEGORY a mapa de categoria do seu componente para especificar que deve ser registrada como implementar a categoria identificada pelo parâmetro de catID .
MESSAGE_HANDLER	Define uma entrada em um mapa de mensagem.
MESSAGE_RANGE_HANDLER	Semelhante a MESSAGE_HANDLER, mas mapeia um intervalo de mensagens do windows em uma única função do manipulador.
NOTIFY_CODE_HANDLER	Semelhante a NOTIFY_HANDLER, mas mapeia uma mensagem de WM_NOTIFY baseada somente no código de notificação.
NOTIFY_HANDLER	Define uma entrada em um mapa de mensagem.
NOTIFY_ID_HANDLER	Semelhante a NOTIFY_HANDLER, mas mapeia uma mensagem de WM_NOTIFY baseada somente no identificador de controle.
NOTIFY_RANGE_CODE_HANDLER	Semelhante a NOTIFY_RANGE_HANDLER, mas às mensagens de WM_NOTIFY de mapas com um código específico de notificação de um intervalo dos controles a um único manipulador funciona.
NOTIFY_RANGE_HANDLER	Semelhante a NOTIFY_HANDLER, mas às mensagens de WM_NOTIFY de mapas de um intervalo dos controles a um único manipulador funciona.
OBJECT_ENTRY_AUTO	Insere um objeto de ATL no mapa do objeto, atualizar o Registro, e cria uma instância do objeto.
OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO	Permite que você especifique que o objeto deve ser registrado e inicializado, mas não deve ser creatable externamente através de CoCreateInstance.
PROP_DATA_ENTRY	Indica a extensão, ou dimensões, de um controle ActiveX.
PROP_ENTRY_INTERFACE	Use este macro para inserir uma descrição da propriedade, uma propriedade DISPID, e uma lista de página de propriedades CLSID no mapa da propriedade para o objeto.
PROP_ENTRY_INTERFACE_CALLBACK	Use este macro para inserir uma descrição da propriedade, DISPID propriedade, e fornecer um função de retorno de chamada para determinar se qualquer CLSID é adicionado ao mapa da propriedade.
PROP_ENTRY_INTERFACE_CALLBACK_EX	Semelhante a PROP_ENTRY_INTERFACE_CALLBACK, mas permite que você especifique um determinado IID se o objeto suporta várias interfaces duais.
PROP_ENTRY_INTERFACE_EX	Semelhante a PROP_ENTRY_INTERFACE, mas permite que você especifique um determinado IID se o objeto suporta várias interfaces duais.
PROP_ENTRY_TYPE	Use este macro para inserir uma descrição da propriedade, uma propriedade DISPID, e uma página de propriedades CLSID no mapa da propriedade do objeto.
PROP_ENTRY_TYPE_EX	Semelhante a PROP_ENTRY_TYPE, mas permite que você especifique um determinado IID se o objeto suporta várias interfaces duais.
PROP_PAGE	Use este macro para inserir uma página de propriedades CLSID no mapa da propriedade do objeto.
RDX_BINARY	Associa a entrada de Registro especificada com um variável de membro especificado de BYTE do tipo.
RDX_CSTRING_TEXT	Associa a entrada de Registro especificada com um variável de membro de tipo especificado CString.
RDX_DWORD	Associa a entrada de Registro especificada com um variável de membro especificado DWORD do tipo.
RDX_TEXT	Associa a entrada de Registro especificada com um variável de membro de tipo especificado TCHAR.
REFLECT_NOTIFICATIONS	Reflete notificações de volta para a janela filho (o controle) que os enviou.
REFLECTED_COMMAND_CODE_HANDLER	Semelhante a COMMAND_CODE_HANDLER, mas mapeia refletidos os comandos da janela pai.
REFLECTED_COMMAND_HANDLER	Semelhante a COMMAND_HANDLER, mas mapeia refletidos os comandos da janela pai.
REFLECTED_COMMAND_ID_HANDLER	Semelhante a COMMAND_ID_HANDLER, mas mapeia refletidos os comandos da janela pai.
REFLECTED_COMMAND_RANGE_CODE_HANDLER	Semelhante a COMMAND_RANGE_CODE_HANDLER, mas mapeia refletidos os comandos da janela pai.
REFLECTED_COMMAND_RANGE_HANDLER	Semelhante a COMMAND_RANGE_HANDLER, mas mapeia refletidos os comandos da janela pai.
REFLECTED_NOTIFY_CODE_HANDLER	Semelhante a NOTIFY_CODE_HANDLER, mas mapeia as notificações refletidas da janela pai.
REFLECTED_NOTIFY_HANDLER	Semelhante a NOTIFY_HANDLER, mas mapeia as notificações refletidas da janela pai.
REFLECTED_NOTIFY_ID_HANDLER	Semelhante a NOTIFY_ID_HANDLER, mas mapeia as notificações refletidas da janela pai.
REFLECTED_NOTIFY_RANGE_CODE_HANDLER	Semelhante a NOTIFY_RANGE_CODE_HANDLER, mas mapeia as notificações refletidas da janela pai.
REFLECTED_NOTIFY_RANGE_HANDLER	Semelhante a NOTIFY_RANGE_HANDLER, mas mapeia as notificações refletidas da janela pai.
REQUIRED_CATEGORY	Adicione uma macro de REQUIRED_CATEGORY a mapa de categoria do seu componente para especificar que deve ser registrada como a exigência de categoria identificada pelo parâmetro de catID .
SERVICE_ENTRY	Indica que o objeto suporta a identificação de serviço especificada por SID.
SERVICE_ENTRY_CHAIN	Instrui IServiceProviderImpl::QueryService encadear ao objeto especificado por punk.
SINK_ENTRY	Declarar a função do manipulador (fn) para o evento especificado (dispid), o controle identificado por id.
SINK_ENTRY_EX	Declarar a função do manipulador (fn) para o evento especificado (dispid), da interface de distribuição (iid), porque o controle identificado por id.
SINK_ENTRY_INFORMATION	Use a macro de SINK_ENTRY_INFO em um mapa o coletor de eventos para fornecer informações requeridas por IDispEventSimpleImpl o roteamento de eventos relevantes à função do manipulador.
SNAPINMENUID	Use este macro para declarar o recurso de menu de contexto de objeto do snap-in.
SNAPINTOOLBARID_ENTRY	Use este macro para inserir um ID da barra de ferramentas no mapa de identificação de barra de ferramentas do snap-in.
WM_FORWARDMSG	Este macro encaminha uma mensagem recebida por uma janela a outra janela para processamento.

Consulte também

Outros recursos

Macros de ATL

Componentes da área de trabalho COM ATL

Funções de ATL

Variáveis globais de ATL

Estruturas de ATL

ATL Typedefs

Visão geral da classe de ATL