Atributos de interfazInterface Attributes

Los siguientes atributos se aplican a la palabra clave Interface (o __interface) C++ .The following attributes apply to the interface (or __interface) C++ keyword.

AtributoAttribute DescripciónDescription
async_uuidasync_uuid Especifica el UUID que dirige el compilador MIDL para definir versiones sincrónicas y asincrónicas de una interfaz COM.Specifies the UUID that directs the MIDL compiler to define both synchronous and asynchronous versions of a COM interface.
customcustom Permite definir sus propios atributos.Lets you define your own attributes.
dispinterfacedispinterface Coloca una interfaz en el archivo .idl como interfaz de envío.Places an interface in the .idl file as a dispatch interface.
dualdual Coloca una interfaz en el archivo. idl como una interfaz dual.Places an interface in the .idl file as a dual interface.
exportexport Hace que una estructura de datos se coloque en el archivo. idl.Causes a data structure to be placed in the .idl file.
helpcontexthelpcontext Especifica un identificador de contexto que permite al usuario ver información sobre este elemento en el archivo de ayuda.Specifies a context ID that lets the user view information about this element in the Help file.
helpfilehelpfile Establece el nombre del archivo de ayuda para una biblioteca de tipos.Sets the name of the Help file for a type library.
helpstringhelpstring Especifica una cadena de caracteres que se usa para describir el elemento al que se aplica.Specifies a character string that is used to describe the element to which it applies.
helpstringcontexthelpstringcontext Especifica el identificador de un tema de ayuda en un archivo. hlp o. chm.Specifies the ID of a help topic in an .hlp or .chm file.
helpstringdllhelpstringdll Especifica el nombre del archivo DLL que se va a usar para realizar la búsqueda de cadenas de documento (localización).Specifies the name of the DLL to use to perform document string lookup (localization).
hiddenhidden Indica que el elemento existe, pero no se debe mostrar en un explorador orientado al usuario.Indicates that the item exists but should not be displayed in a user-oriented browser.
library_blocklibrary_block Coloca una construcción dentro del bloque de biblioteca del archivo. idl.Places a construct inside the .idl file's library block.
locallocal Permite usar el compilador MIDL como generador de encabezados cuando se usa en el encabezado de la interfaz.Allows you to use the MIDL compiler as a header generator when used in the interface header. Cuando se usa en una función individual, designa un procedimiento local para el que no se genera ningún código auxiliar.When used in an individual function, designates a local procedure for which no stubs are generated.
nonextensiblenonextensible Especifica que la implementación de IDispatch solo incluye las propiedades y los métodos enumerados en la descripción de la interfaz y no se puede extender con miembros adicionales en tiempo de ejecución.Specifies that the IDispatch implementation includes only the properties and methods listed in the interface description and cannot be extended with additional members at run time. Este atributo solo es válido en una interfaz dual .This attribute is only valid on a dual interface.
odlodl Identifica una interfaz como una interfaz de lenguaje de descripción de objetos (ODL).Identifies an interface as an Object Description Language (ODL) interface.
objectobject Identifica una interfaz personalizada.Identifies a custom interface.
oleautomationoleautomation Indica que una interfaz es compatible con la automatización.Indicates that an interface is compatible with Automation.
pointer_defaultpointer_default Especifica el atributo de puntero predeterminado para todos los punteros, excepto los punteros de nivel superior que aparecen en las listas de parámetros.Specifies the default pointer attribute for all pointers except top-level pointers that appear in parameter lists.
ptrptr Designa un puntero como un puntero completo.Designates a pointer as a full pointer.
restrictedrestricted Designa a qué miembros de la biblioteca no se puede llamar arbitrariamente.Designates which members of the library cannot be called arbitrarily.
uuiduuid Proporciona el identificador único de la biblioteca.Provides the unique ID for the library

Debe observar estas reglas para definir una interfaz:You must observe these rules for defining an interface:

  • La Convención de llamada predeterminada es __stdcall.Default calling convention is __stdcall.

  • Si no proporciona uno, se le proporciona un GUID.A GUID is supplied for you if you do not supply one.

  • No se permite ningún método sobrecargado.No overloaded methods are allowed.

Cuando no se especifica el atributo UUID y se usa el mismo nombre de interfaz en distintos proyectos de atributos, se genera el mismo GUID.When not specifying the uuid attribute and using the same interface name in different attribute projects, the same GUID is generated.

Consulte tambiénSee also

Atributos por usoAttributes by Usage