registration_script
Executa o script de registro personalizado especificado.
Sintaxe
[ registration_script(script) ]
Parâmetros
script
O caminho completo para um arquivo de script de registro personalizado (.rgs). Um valor nenhum, como script = "none"
, indica que coclass não tem requisitos de registro.
Comentários
O atributo registration_script C++ executa o script de registro personalizado especificado pelo script. Se esse atributo não for especificado, será utilizado um arquivo .rgs padrão (contendo as informações para registro do componente). Para obter mais informações sobre os arquivos .rgs, consulte O componente de registro de ATL (registrador).
Esse atributo requer que o atributo coclass, progid ou vi_progid (ou outro atributo que implique um desses) também seja aplicado ao mesmo elemento.
Exemplo
O código a seguir especifica que o componente possui um script de registro chamado cpp_attr_ref_registration_script.rgs.
// cpp_attr_ref_registration_script.cpp
// compile with: /LD
#define _ATL_ATTRIBUTES
#include "atlbase.h"
#include "atlcom.h"
[module (name="REG")];
[object, uuid("d9cd196b-6836-470b-9b9b-5b04b828e5b0")]
__interface IFace {};
// requires "cpp_attr_ref_registration_script.rgs"
// create sample .RGS file "cpp_attr_ref_registration_script.rgs" if it does not exist
[ coclass, registration_script(script="cpp_attr_ref_registration_script.rgs"),
uuid("50d3ad42-3601-4f26-8cfe-0f1f26f98f67")]
class CMyClass:public IFace {};
Requisitos
Contexto do atributo | Valor |
---|---|
Aplicável ao | class , struct |
Repetível | Não |
Atributos obrigatórios | Um ou mais dos seguintes: coclass , progid ou vi_progid . |
Atributos inválidos | Nenhum |
Para obter mais informações sobre os contextos de atributo, confira Contextos de atributo.