Interface ICertExit (certexit.h)

  • Artigo

A interface ICertExit fornece comunicações entre o servidor dos Serviços de Certificados e um módulo de saída.

Nota O módulo de saída pode se comunicar com o servidor dos Serviços de Certificados usando a interface ICertServerExit .
 
O servidor dos Serviços de Certificados chama os métodos ICertExit para executar as seguintes tarefas:
  • Inicialize o servidor dos Serviços de Certificados.
  • Notificar o módulo de saída de um evento, como emissão de certificado, emissão de CRL ( lista de revogação de certificado ) ou desligamento do servidor, ocorreu.
  • Recupere uma descrição do módulo de saída.

ICertExit é definido em Certexit.h. No entanto, ao criar seu programa, use Certsrv.h como o arquivo de inclusão.

As interfaces dos Serviços de Certificados dão suporte a modelos apartment-threading e free-threading. Para uma melhor taxa de transferência, o threading gratuito é recomendado.

Herança

A interface ICertExit herda da interface IDispatch . O ICertExit também tem esses tipos de membros:

Métodos

A interface ICertExit tem esses métodos.

 
ICertExit::GetDescription

Retorna uma descrição legível por humanos do módulo de saída e sua função.
ICertExit::Initialize

Chamado pelo mecanismo de servidor quando ele se inicializa.
ICertExit::Notify

Chamado pelo mecanismo de servidor para notificar um módulo de saída de que ocorreu um evento.

Comentários

Os implementadores do ICertExit também devem implementar ICertManageModule. Além disso, o ProgID para uma classe que implementa ICertExit deve estar em conformidade com uma convenção de nomenclatura. Especificamente, o ProgID deve ser do formulário:

"MyApp. Sair"

Em que MyApp é um especificador que identifica o aplicativo. Por exemplo, em C++, o código a seguir pode ser usado na macro DECLARE_REGISTRY de uma classe (CMyCertExitModule) que implementa ICertExit.

DECLARE_REGISTRY(
    CMyCertExitModule,
    L"MyCode.Exit.1",
    L"MyCode.Exit",
    IDS_CERTEXITMODULE_DESC,
    THREADFLAGS_BOTH)

Para o exemplo anterior, o valor IDS_CERTEXITMODULE_DESC é um identificador específico do aplicativo no arquivo de recurso (.rc) para uma cadeia de caracteres que descreve a classe .

As constantes de cadeia de caracteres definidas em Certmod.h podem ser usadas para simplificar o seguindo a convenção de nomenclatura.

Constante Valor
wszCERTEXITMODULE_POSTFIX TEXT(". Sair")
 

Não mais do que um módulo de saída do Visual Basic Scripting Edition pode ser registrado no servidor de Serviços de Certificados de uma só vez. Se mais de um módulo de saída do Visual Basic Scripting Edition estiver registrado, o snap-in MMC da Autoridade de Certificação, o aplicativo de Serviços de Certificados ou o programa de linha de comando certutil poderão produzir erros. Observe que o ambiente de desenvolvimento do Visual Basic Scripting Edition registra automaticamente uma DLL quando ela é criada com êxito. Como resultado, você pode encontrar essa situação quando um módulo de saída do Visual Basic Scripting Edition já estiver registrado e outro módulo de saída do Visual Basic Scripting Edition for criado. Para evitar essa situação, você deve cancelar o registro de um dos módulos de saída do Visual Basic Scripting Edition, por meio da instrução de linha de comando regsvr32 /u FileName.dll, em que FileName.dll é o nome do módulo de saída do Visual Basic Scripting Edition que não se destina a ficar ativo.

Os implementadores do ICertExit no Visual Basic Scripting Edition devem nomear seu projeto no formulário:

"MyApp"

Em que MyApp é um especificador que identifica o aplicativo; além disso, a classe que implementa ICertExit deve ser chamada de "Exit".

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certexit.h (inclua Certsrv.h)

Confira também

ICertServerExit

IDispatch