ATL Macros Alphabetical Reference

En esta sección, temas de referencia para las macros de ATL se organizan alfabéticamente. Para buscar una macro determinada por categoría, vea macros de ATL.

Macro

Descripción

_ATL_ALL_WARNINGS

Un símbolo que habilita errores en proyectos convirtió de versiones anteriores de ATL.

_ATL_APARTMENT_THREADED

defina si uno o más de los objetos utilizan subproceso controlado.

_ATL_CSTRING_EXPLICIT_CONSTRUCTORS

Crea a algunos constructores de CString explícitos, evitando cualquier conversión no deseada.

_ATL_DEBUG_INTERFACES

Defina esta macro antes incluidos los archivos de encabezado ATL para traza todo el AddRef y llamadas de Liberar en las interfaces de los componentes en la ventana de salida.

_ATL_DEBUG_QI

Escribe todas las llamadas a QueryInterface a la ventana de salida.

_ATL_FREE_THREADED

Defina si uno o más de los objetos libre o el subprocesamiento neutro.

_ATL_MIXED

Indica al compilador que la aplicación ATL está comprendida de nativo y de los elementos de /clr .

_ATL_MULTI_THREADED

Un símbolo que indica el proyecto tendrá objetos marcadas como Both, free o Neutro. _ATL_FREE_THREADED Macro se debe utilizar en nuevo código.

_ATL_NO_COM_SUPPORT

Un símbolo que impida que el código COM-relacionado se compila con el proyecto.

_ATL_NO_AUTOMATIC_NAMESPACE

Un símbolo que evita el uso predeterminado namespace como ATL.

_ATL_NO_VARIANT_THROW

Suprime CComVariant Class de excepciones.

_ATL_SECURE_NO_WARNINGS

Suprime las advertencias del compilador para el uso de las funciones obsoletas ATL.

_ATL_STATIC_REGISTRY

Un símbolo que indica desea que el código de registro para que el objeto está en el objeto para evitar dependencias en ATL.DLL.

_ATLCATCH

Instrucciones para controlar los errores que aparecen en _ATLTRYasociado

_ATLCATCHALL

Instrucciones para controlar los errores que aparecen en _ATLTRYasociado.

_ATLTRY

marca una sección de código guardada donde un error podría aparecer posiblemente.

ATL_ESC marca

Estos marcadores se utilizan para controlar el comportamiento de EscapeXML.

ALT_MSG_MAP

Marca el principio de un mapa de mensajes alternativo.

Macros de conversión de cadena ATL y MFC

Macros de la conversión de cadenas válidas para ATL y MFC.

ATLASSERT

La macro de ATLASSERT realiza la misma funcionalidad que la macro de _ASSERTE encontrada en la biblioteca en tiempo de ejecución de C.

ATL_NOINLINE

Un símbolo que indica una función no debe insertadas.

ATL_NO_VTABLE

Un símbolo que evita que el puntero vtable es inicializar en el constructor y el destructor de clase.

ATL_URL Flags

Estas marcas modifican el comportamiento de AtlEscapeUrl y de AtlCanonicalizeUrl.

ATL_URL_SCHEME

Los miembros de esta enumeración proporcionan las constantes para esquemas entendidos por rizo.

ATL_WORKER_THREAD_WAIT

Esta macro define el valor predeterminado en milisegundos que CWorkerThread::Shutdown esperará el subproceso de trabajo para cerrar.

ATLS_DEFAULT_THREADPOOLSHUTDOWNTIMEOUT

esta macro define la hora predeterminada en milisegundos que CThreadPool esperará un subproceso para cerrar.

ATLS_DEFAULT_THREADSPERPROC

esta macro define el número predeterminado de subprocesos por el procesador utilizado por CThreadPool.

Marcadores de ATLSMTP_QPENCODE

Estos marcadores describen cómo la codificación citar-imprimible debe ser realizada por QPEncode.

Marcadores de ATLSMTP_UUENCODE

Estos marcadores describen cómo el uuencoding debe realizarse por uuencode.

ATLTRACE

Advertencias de los informes en un dispositivo de salida, como la ventana del depurador, según los marcadores y los niveles indicados. Incluido por compatibilidad con versiones anteriores.

ATLTRA CE2

Advertencias de los informes en un dispositivo de salida, como la ventana del depurador, según los marcadores y los niveles indicados.

ATLTRACENOTIMPL

En las compilaciones de depuración ATL, envía la cadena “funcname no se implementa” al dispositivo de volcado y no devuelve E_NOTIMPL.

BEGIN_CATEGORY_MAP

Marca el principio del mapa de la categoría.

BEGIN_COM_MAP

El mapa COM es el mecanismo que expone interfaces en un objeto a un cliente con QueryInterface.

BEGIN_CONNECTION_POINT_MAP

Marca el principio de las entradas del mapa de puntos de conexión.

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

Marca el principio de la asignación del tipo de datos de la extensión del complemento.

BEGIN_MSG_MAP

Marca el principio del mapa de mensajes predeterminado.

BEGIN_PROP_MAP

Marca el principio del mapa de propiedades del objeto.

BEGIN_RDX_MAP

Marca el principio del mapa de Data Exchange del registro.

BEGIN_SERVICE_MAP

Marca el principio del mapa del servicio.

BEGIN_SINK_MAP

Declara el principio del mapa de receptor de eventos para el control compuesto.

BEGIN_SNAPINTOOLBARID_MAP

Declara el principio del identificador de la barra de herramientas asignado para el objeto del complemento.

CHAIN_MSG_MAP

Define una entrada en un mapa de mensajes.

CHAIN_MSG_MAP_ALT

Define una entrada en un mapa de mensajes.

CHAIN_MSG_MAP_ALT_MEMBER

Define una entrada en un mapa de mensajes.

CHAIN_MSG_MAP_DYNAMIC

Define una entrada en un mapa de mensajes.

CHAIN_MSG_MAP_MEMBER

Define una entrada en un mapa de mensajes.

macros de COM_INTERFACE_ENTRY

Estas macros escriba las interfaces de un objeto en el mapa COM para que puedan tener acceso QueryInterface.

COM_INTERFACE_ENTRY

Interfaces de las ENTRAR en el mapa de interfaz COM.

COM_INTERFACE_ENTRY2

Use esta macro para eliminar la ambigüedad de dos bifurcaciones de herencia.

COM_INTERFACE_ENTRY2_IID

Igual que COM_INTERFACE_ENTRY2, a menos que puede especificar otro identificador IID.

COM_INTERFACE_ENTRY_AGGREGATE

Cuando la interfaz identificada por iid se consulta para, COM_INTERFACE_ENTRY_AGGREGATE reenvía a punk.

COM_INTERFACE_ENTRY_AGGREGATE_BLIND

Igual que COM_INTERFACE_ENTRY_AGGREGATE, salvo que consultar los resultados de IID reenvíe la consulta a punk.

COM_INTERFACE_ENTRY_AUTOAGGREGATE

Igual que COM_INTERFACE_ENTRY_AGGREGATE, excepto si punk es NULL, crea automáticamente el agregado descrito por clsid.

COM_INTERFACE_ENTRY_AUTOAGGREGATE_BLIND

Igual que COM_INTERFACE_ENTRY_AUTOAGGREGATE, salvo que consultar cualquier IID da lugar a reenviar la consulta a punk, y si punk es NULL, automáticamente creando el agregado descrito por clsid.

COM_INTERFACE_ENTRY_BREAK

El programa para llamar a DebugBreak cuando la interfaz especificada se consulta para.

COM_INTERFACE_ENTRY_CACHED_TEAR_OFF

guarda los datos interfaz-específicos para cada instancia.

COM_INTERFACE_ENTRY_CHAIN

Procesa el mapa COM de la clase base al procesamiento alcanza esta entrada en el mapa COM.

COM_INTERFACE_ENTRY_FUNC

Un mecanismo general para enlazar en QueryInterface ATL lógica.

COM_INTERFACE_ENTRY_FUNC_BLIND

Igual que COM_INTERFACE_ENTRY_FUNC, salvo que consultar cualquier IID produce una llamada a func.

COM_INTERFACE_ENTRY_IID

Use esta macro para escribir la interfaz en el mapa COM y especificar su identificador IID.

COM_INTERFACE_ENTRY_NOINTERFACE

Devuelve E_NOINTERFACE y finaliza el procesamiento del mapa COM cuando la interfaz especificada se consulta para.

COM_INTERFACE_ENTRY_TEAR_OFF

Expone las interfaces de rasgón.

COMMAND_CODE_HANDLER

Similar a COMMAND_HANDLER, pero asigna un mensaje de WM_COMMAND basado únicamente en el código de notificación.

COMMAND_HANDLER

Define una entrada en un mapa de mensajes.

COMMAND_ID_HANDLER

Similar a COMMAND_HANDLER, pero asigna un mensaje de WM_COMMAND basado únicamente en el identificador del elemento de menú, del control, o de aceleradores.

COMMAND_RANGE_CODE_HANDLER

Similar a COMMAND_RANGE_HANDLER; los mensajes de WM_COMMAND maps con un código específico de la notificación de un intervalo de controles a un único controlador funcione.

COMMAND_RANGE_HANDLER

Similar a COMMAND_HANDLER; los mensajes de WM_COMMAND de mapas de un intervalo de controles a una sola función de controlador.

CONNECTION_POINT_ENTRY

Escribe un punto de conexión para la interfaz especificada en el punto de conexión asignado para que se pueda tener acceso.

DECLARE_AGGREGATABLE

Especifica que el objeto puede agregarse.

DECLARE_CLASSFACTORY

Declara CComClassFactory para el generador de clases.

DECLARE_ CLASSFACTORY2

Declara CComClassFactory2 para el generador de clases.

DECLARE_CLASSFACTORY_AUTO_THREAD

Declara CComClassFactoryAutoThread para el generador de clases.

DECLARE_CLASSFACTORY_EX

Declara cf para el generador de clases.

DECLARE_CLASSFACTORY_SINGLETON

Declara CComClassFactorySingleton para el generador de clases.

DECLARE_EMPTY_MSG_MAP

Declara un mapa de mensajes vacío.

DECLARE_GET_CONTROLLING_UNKNOWN

declara una función virtual GetControllingUnknown.

DECLARE_LIBID

Proporciona una manera de que ATL obtenga el libid de la biblioteca de tipos.

DECLARE_NO_REGISTRY

Utilice DECLARE_NO_REGISTRY si desea evitar cualquier registro predeterminado ATL para la clase en la que esta macro aparece.

DECLARE_NOT_AGGREGATABLE

Especifica que el objeto no se puede agregar.

DECLARE_OBJECT_DESCRIPTION

Permite especificar una descripción de texto del objeto de clase.

DECLARE_OLEMISC_STATUS

Utilizado en controles ATL ActiveX para establecer el OLEMISC marca.

DECLARE_ONLY_AGGREGATABLE

Especifica que el objeto debe agregarse.

DECLARE_POLY_AGGREGATABLE

Especifica que una instancia de CComPolyObject < x > se crea cuando se crea el objeto.

DECLARE_PROTECT_FINAL_CONSTRUCT

Protege el objeto de eliminar si (durante FinalConstruct) el objeto agregado interno incrementa el recuento de referencias después disminuye el recuento en 0.

DECLARE_REGISTRY

Escribe el registro estándar de la clase del sistema o lo quita del registro del sistema.

DECLARE_REGISTRY_APPID_RESOURCEID

Especifica la información necesaria automáticamente para registrar el appid.

DECLARE_REGISTRY_RESOURCE

Obtiene el recurso denominado que contiene el archivo de registro y ejecute el script que incorporan objetos del sistema o quitarlos de registro del sistema.

DECLARE_REGISTRY_RESOURCEID

Igual que DECLARE_REGISTRY_RESOURCE excepto que utiliza UINT generado por el para identificar el recurso, en lugar de un nombre de cadena.

DECLARE_VIEW_STATUS

Coloque esta macro en una clase de control ATL ActiveX para especificar marcadores de VIEWSTATUS al contenedor.

DECLARE_WND_CLASS

Permite especificar el nombre de una nueva clase de ventana. Coloque esta macro en una clase de control ATL ActiveX.

DECLARE_WND_CLASS_EX

Permite especificar el nombre de una clase de ventana existente en la que una nueva clase de ventana está basada en. Coloque esta macro en una clase de control ATL ActiveX.

DECLARE_WND_SUPERCLASS

Permite especificar los parámetros de una clase. Coloque esta macro en una clase de control ATL ActiveX.

DEFAULT_REFLECTION_HANDLER

Proporciona un controlador predeterminado para la ventana secundaria (control) que recibirá los mensajes reflejados; el controlador pasará correctamente mensajes no controlados a DefWindowProc.

Macros de conversión de cadena de DEVMODE y de TEXTMETRIC

Estas macros crean una copia de una estructura de DEVMODE o de TEXTMETRIC y convierten cadenas dentro de la nueva estructura en un nuevo tipo string.

END_CATEGORY_MAP

Marca el final del mapa de la categoría.

END_COM_MAP

Finaliza la definición de mapas de interfaz COM.

END_CONNECTION_POINT_MAP

Marca el final de las entradas del mapa de puntos de conexión.

END_EXTENSION_SNAPIN_NODEINFO_MAP

Marca el final de la asignación del tipo de datos de la extensión del complemento.

END_MSG_MAP

Marca el final de un mapa de mensajes.

END_PROP_MAP

Marca el final del mapa de propiedades del objeto.

END_RDX_MAP

Marca el final del mapa de Data Exchange del registro.

END_SERVICE_MAP

Marca el final del mapa del servicio.

END_SINK_MAP

Declara el final del mapa de receptor de eventos para el control compuesto.

END_SNAPINTOOLBARID_MAP

Declara el final del identificador de la barra de herramientas asignado para el objeto del complemento.

EXTENSION_SNAPIN_DATACLASS

Agrega un miembro de datos a la clase de datos de la extensión del complemento para ISnapInItemImpl- clase derivada.

EXTENSION_SNAPIN_NODEINFO_ENTRY

Agrega una clase de datos de la extensión del complemento a la asignación del tipo de datos de la extensión del complemento.

FORWARD_NOTIFICATIONS

transmite a mensajes de notificación la ventana primaria.

IMPLEMENTED_CATEGORY

Agregue una macro de IMPLEMENTED_CATEGORY a mapa de categoría de componente para especificar debería registrarse como implementar la categoría identificada por el parámetro de catID .

MESSAGE_HANDLER

Define una entrada en un mapa de mensajes.

MESSAGE_RANGE_HANDLER

Similar a MESSAGE_HANDLER, pero asigna un intervalo de mensajes de Windows a una sola función de controlador.

NOTIFY_CODE_HANDLER

Similar a NOTIFY_HANDLER, pero asigna un mensaje de WM_NOTIFY basado únicamente en el código de notificación.

NOTIFY_HANDLER

Define una entrada en un mapa de mensajes.

NOTIFY_ID_HANDLER

Similar a NOTIFY_HANDLER, pero asigna un mensaje de WM_NOTIFY basado únicamente en el identificador de control.

NOTIFY_RANGE_CODE_HANDLER

Similar a NOTIFY_RANGE_HANDLER; los mensajes de WM_NOTIFY maps con un código específico de la notificación de un intervalo de controles a un único controlador funcione.

NOTIFY_RANGE_HANDLER

Similar a NOTIFY_HANDLER; los mensajes de WM_NOTIFY de mapas de un intervalo de controles a una sola función de controlador.

OBJECT_ENTRY_AUTO

Escribe un objeto ATL en el mapa del objeto, actualice el registro, y crea una instancia de objeto.

OBJECT_ENTRY_NON_CREATEABLE_EX_AUTO

Permite especificar que inicializan el objeto está registrado y, pero no se debe externamente pueden crearse mediante CoCreateInstance.

PROP_DATA_ENTRY

Indica la extensión, o dimensiones, un control ActiveX.

PROP_ENTRY_INTERFACE

Use esta macro para escribir una descripción de propiedad, una propiedad DISPID, y una lista de página de propiedades CLSID en el mapa de propiedades para el objeto.

PROP_ENTRY_INTERFACE_CALLBACK

Use esta macro para escribir una descripción de la propiedad, propiedad DISPID, y proporcione una función de devolución de llamada para determinar si algún CLSID se agrega al mapa de propiedades.

PROP_ENTRY_INTERFACE_CALLBACK_EX

Similar a PROP_ENTRY_INTERFACE_CALLBACK, pero permite especificar un identificador IID determinado si el objeto admite interfaces duales múltiples.

PROP_ENTRY_INTERFACE_EX

Similar a PROP_ENTRY_INTERFACE, pero permite especificar un identificador IID determinado si el objeto admite interfaces duales múltiples.

PROP_ENTRY_TYPE

Use esta macro para escribir una descripción de propiedad, una propiedad DISPID, y una página de propiedades CLSID en el mapa de propiedades del objeto.

PROP_ENTRY_TYPE_EX

Similar a PROP_ENTRY_TYPE, pero permite especifican un identificador IID determinado si el objeto admite interfaces duales múltiples.

PROP_PAGE

Use esta macro para especificar una página de propiedades CLSID en el mapa de propiedades del objeto.

RDX_BINARY

Asocia la entrada de Registro especificada una variable miembro especificada de BYTE escrito.

RDX_CSTRING_TEXT

Asocia la entrada de Registro especificada una variable miembro especificada de tipo CString.

RDX_DWORD

Asocia la entrada de Registro especificada una variable miembro especificada del tipo DWORD.

RDX_TEXT

Asocia la entrada de Registro especificada una variable miembro especificada de TCHAR escrito.

REFLECT_NOTIFICATIONS

Refleja mensajes de notificación a la ventana secundaria (control) que los envió.

REFLECTED_COMMAND_CODE_HANDLER

Similar a COMMAND_CODE_HANDLER, pero asigna los comandos reflejarán de la ventana primaria.

REFLECTED_COMMAND_HANDLER

Similar a COMMAND_HANDLER, pero asigna los comandos reflejarán de la ventana primaria.

REFLECTED_COMMAND_ID_HANDLER

Similar a COMMAND_ID_HANDLER, pero asigna los comandos reflejarán de la ventana primaria.

REFLECTED_COMMAND_RANGE_CODE_HANDLER

Similar a COMMAND_RANGE_CODE_HANDLER; los comandos maps reflejarán de la ventana primaria.

REFLECTED_COMMAND_RANGE_HANDLER

Similar a COMMAND_RANGE_HANDLER, pero asigna los comandos reflejarán de la ventana primaria.

REFLECTED_NOTIFY_CODE_HANDLER

similar a NOTIFY_CODE_HANDLER, pero asigna las notificaciones reflejadas de la ventana primaria.

REFLECTED_NOTIFY_HANDLER

similar a NOTIFY_HANDLER, pero a las notificaciones de los mapas reflejadas de la ventana primaria.

REFLECTED_NOTIFY_ID_HANDLER

similar a NOTIFY_ID_HANDLER, pero a las notificaciones de los mapas reflejadas de la ventana primaria.

REFLECTED_NOTIFY_RANGE_CODE_HANDLER

similar a NOTIFY_RANGE_CODE_HANDLER, pero asigna las notificaciones reflejadas de la ventana primaria.

REFLECTED_NOTIFY_RANGE_HANDLER

similar a NOTIFY_RANGE_HANDLER, pero asigna las notificaciones reflejadas de la ventana primaria.

REQUIRED_CATEGORY

Agregue una macro de REQUIRED_CATEGORY a mapa de categoría de componente para especificar debería registrarse como requerir la categoría identificada por el parámetro de catID .

SERVICE_ENTRY

Indica que el objeto admite el id. de servicio especificado por un SID.

SERVICE_ENTRY_CHAIN

Indica a IServiceProviderImpl:: QueryService para encadenar al objeto especificado por punk.

SINK_ENTRY

Declara la función controladora (fn) para el evento especificado (dispid), el control identificado por id.

SINK_ENTRY_EX

Declara la función controladora (fn) para el evento especificado (dispid), de la interfaz de envío, porque el control identificado por id.

SINK_ENTRY_INFORMATION

Utilice la macro de SINK_ENTRY_INFO dentro de un mapa de receptor de eventos para proporcionar la información necesaria para IDispEventSimpleImpl para distribuir eventos a la función pertinente de controlador.

SNAPINMENUID

Use esta macro para declarar el recurso de menú contextual del objeto del complemento.

SNAPINTOOLBARID_ENTRY

Use esta macro para especificar un identificador de la barra de herramientas en el mapa del identificador de la barra de herramientas del complemento.

WM_FORWARDMSG

Esta macro reenvía un mensaje recibido por una ventana a otra ventana para procesar.

Vea también

Otros recursos

Macros de ATL

ATL COM Desktop Components

ATL Functions

ATL Global Variables

ATL Structures

ATL Typedefs

ATL Class Overview