Compartilhar via

Função CertSrvRestoreEnd (certbcli.h)

  • Artigo

A função CertSrvRestoreEnd encerra uma sessão de restauração dos Serviços de Certificados.

Sintaxe

HRESULT CERTBCLI_API CertSrvRestoreEnd(
  [in] HCSBC hbc
);

Parâmetros

[in] hbc

Um identificador para um contexto de backup dos Serviços de Certificados.

Retornar valor

O valor retornado é um HRESULT. Um valor de S_OK indica êxito.

Comentários

Quando uma sessão de restauração for concluída, encerre a sessão chamando CertSrvRestoreEnd. Para cada chamada bem-sucedida para CertSrvRestorePrepare, deve haver uma chamada para CertSrvRestoreEnd.

Quando uma restauração é concluída, é importante que você faça um novo backup completo do banco de dados dos Serviços de Certificados. Isso é necessário para truncar os arquivos de log restaurados e estabelecer um conjunto de backup base para restaurações futuras. Os backups executados após uma restauração não podem ser misturados com backups (completos ou incrementais) feitos antes da restauração; ou seja, depois que um banco de dados de serviços de certificado é restaurado e progrediu para um estado subsequente, você não pode usar os backups de pré-restauração para restaurar o banco de dados para esse estado subsequente.

Exemplos

FNCERTSRVRESTOREEND*  pfnRestoreEnd;
char * szRestoreEndFunc = "CertSrvRestoreEnd";
HRESULT    hr=0;
	
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnRestoreEnd = (FNCERTSRVRESTOREEND*)GetProcAddress(hInst,
                                  szRestoreEndFunc);
if ( NULL == pfnRestoreEnd )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szRestoreEndFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// When done, release the HCSBC.
// hCSBC would have been set by an earlier call
// to CertSrvRestorePrepare.
hr = pfnRestoreEnd(hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnRestoreEnd call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

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 certbcli.h (inclua Certsrv.h)
Biblioteca Certadm.lib
DLL Certadm.dll

Confira também

CertSrvRestorePrepare

Usando as funções de backup e restauração dos Serviços de Certificados