Fonction CertSrvRestoreEnd (certbcli.h)

Article
08/22/2023

La fonction CertSrvRestoreEnd met fin à une session de restauration des services de certificats.

Syntaxe

HRESULT CERTBCLI_API CertSrvRestoreEnd(
  [in] HCSBC hbc
);

Paramètres

[in] hbc

Handle vers un contexte de sauvegarde des services de certificats.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique la réussite.

Remarques

Lorsqu’une session de restauration est terminée, terminez la session en appelant CertSrvRestoreEnd. Pour chaque appel réussi à CertSrvRestorePrepare, il doit y avoir un appel à CertSrvRestoreEnd.

Lorsqu’une restauration est terminée, il est important d’effectuer une nouvelle sauvegarde complète de la base de données des services de certificats. Cela est nécessaire pour tronquer les fichiers journaux restaurés et établir un jeu de sauvegarde de base pour les restaurations ultérieures. Les sauvegardes effectuées après une restauration ne peuvent pas être mixtes avec les sauvegardes (complètes ou incrémentielles) effectuées avant la restauration ; autrement dit, une fois qu’une base de données de services de certificat a été restaurée et qu’elle est passée à un état ultérieur, vous ne pouvez pas utiliser les sauvegardes de prérestauration pour restaurer la base de données à cet état suivant.

Exemples

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.
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certbcli.h (include Certsrv.h)
Bibliothèque	Certadm.lib
DLL	Certadm.dll

Voir aussi

CertSrvRestorePrepare

Utilisation des fonctions de sauvegarde et de restauration des services de certificat

Partager via