progid

Especifica o ProgID para um objeto COM.

Sintaxe

[ progid(name) ];

Parâmetros

name
A ProgID que representa o objeto.

Os ProgIDs apresentam uma versão legível para humanos do CLSID (identificador de classe) usado para identificar objetos COM/ActiveX.

Comentários

O atributo C++ progid permite que você especifique o ProgID para um objeto COM. Um ProgID tem o formato name1.name2.version. Se você não especificar uma versão para um ProgID, a versão padrão será 1. Se você não especificar name1.name2, o nome padrão será classname.classname. Se você não especificar progid e especificar vi_progid, name1.name2 será obtido vi_progid e a versão (próximo número sequencial) será acrescentada.

Se um bloco de atributo que usa progid não usar também uuid, o compilador verificará o registro para ver se existe um uuid para o progid especificado. Se progid não for especificado, a versão (e o nome da coclasse, se uma coclasse estiver sendo criada) será usada para gerar um progid.

progid implica o atributo coclass, ou seja, especificar progid é o mesmo que especificar os atributos coclass eprogid.

O atributo progid faz com que uma classe seja registrada automaticamente sob o nome especificado. O arquivo .idl gerado não exibirá o valor progid.

Quando esse atributo é usado em um projeto que usa ATL, o comportamento do atributo é alterado. Além do comportamento acima, as informações especificadas com esse atributo são usadas na função GetProgID, injetadas pelo atributo coclass. Para mais informações, confira o atributo coclass.

Exemplo

Confira o exemplo de coclasse para obter um exemplo de uso de progid.

Requisitos

Contexto do atributo	Valor
Aplicável ao	class, struct
Repetível	Não
Atributos obrigatórios	Nenhum
Atributos inválidos	Nenhum

Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.

Confira também

Atributos de IDL
Atributos de classe
Atributos Typedef, Enum, Union e Struct
Chave ProgID