Partilhar via


Atributos de interface

Os atributos a seguir se aplicam à palavra-chave do C++ interface (ou __interface).

Atributo Descrição
async_uuid Especifica a UUID que direciona o compilador MIDL para definir versões síncronas e assíncronas de uma interface COM.
personalizado Permite que você defina seus próprios atributos.
dispinterface Coloca uma interface no arquivo .idl como uma interface de expedição.
dual Coloca uma interface no arquivo .idl como uma interface dupla.
exportar Faz com que uma estrutura de dados seja colocada no arquivo .idl.
helpcontext Especifica uma ID de contexto que permite ao usuário exibir informações sobre este elemento no arquivo de Ajuda.
helpfile Define o nome do arquivo de Ajuda para uma biblioteca de tipos.
helpstring Especifica uma cadeia de caracteres que é usada para descrever o elemento ao qual ela se aplica.
helpstringcontext Especifica a ID de um tópico de ajuda em um arquivo .hlp ou .chm.
helpstringdll Especifica o nome da DLL a ser usada para executar a pesquisa de cadeia de caracteres do documento (localização).
hidden Indica que o item existe, mas não deve ser exibido em um navegador orientado ao usuário.
library_block Coloca um constructo dentro do bloco de biblioteca do arquivo .idl.
local Permite que você use o compilador MIDL como um gerador de cabeçalho quando usado no cabeçalho da interface. Quando usado em uma função individual, designa um procedimento local para o qual nenhum stub é gerado.
nonextensible Especifica que a implementação IDispatch inclui apenas as propriedades e os métodos listados na descrição da interface e não pode ser estendido com membros adicionais em tempo de execução. Esse atributo só é válido em uma interface dual.
odl Identifica uma interface como uma interface ODL (Object Description Language).
object Identifica uma interface personalizada.
oleautomation Indica que uma interface é compatível com Automação.
pointer_default Especifica o atributo de ponteiro padrão para todos os ponteiros, exceto ponteiros de nível superior que aparecem em listas de parâmetros.
ptr Designa um ponteiro como um ponteiro completo.
restricted Designa quais membros da biblioteca não podem ser chamados arbitrariamente.
uuid Fornece a ID exclusiva da biblioteca.

Você deve observar essas regras para definir uma interface:

  • A convenção de chamada padrão é __stdcall.

  • Um GUID será fornecido se você não fornecer um.

  • Nenhum método sobrecarregado é permitido.

Ao não especificar o atributo uuid e usar o mesmo nome de interface em projetos de atributo diferentes, o mesmo GUID é gerado.

Confira também

Atributos por uso