CertSrvRestoreEnd-Funktion (certbcli.h)

Artikel
03/01/2024

Die CertSrvRestoreEnd-Funktion beendet eine Zertifikatdienste-Wiederherstellungssitzung.

Syntax

HRESULT CERTBCLI_API CertSrvRestoreEnd(
  [in] HCSBC hbc
);

Parameter

[in] hbc

Ein Handle für einen Sicherungskontext für Zertifikatdienste.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt den Erfolg an.

Hinweise

Wenn eine Wiederherstellungssitzung abgeschlossen ist, beenden Sie die Sitzung, indem Sie CertSrvRestoreEnd aufrufen. Für jeden erfolgreichen Aufruf von CertSrvRestorePrepare sollte ein Aufruf von CertSrvRestoreEnd erfolgen.

Wenn eine Wiederherstellung abgeschlossen ist, ist es wichtig, dass Sie eine neue vollständige Sicherung der Zertifikatdienste-Datenbank erstellen. Dies ist erforderlich, um die wiederhergestellten Protokolldateien abzuschneiden und einen Basissicherungssatz für zukünftige Wiederherstellungen einzurichten. Sicherungen, die nach einer Wiederherstellung ausgeführt werden, können nicht mit (vollständigen oder inkrementellen) Sicherungen gemischt werden, die vor der Wiederherstellung erstellt wurden. Das heißt, nachdem eine Zertifikatdienstdatenbank wiederhergestellt wurde und in einen nachfolgenden Zustand versetzt wurde, können Sie die Sicherungen vor der Wiederherstellung nicht verwenden, um die Datenbank in diesen nachfolgenden Zustand wiederherzustellen.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certbcli.h (certsrv.h einschließen)
Bibliothek	Certadm.lib
DLL	Certadm.dll

Weitere Informationen

CertSrvRestorePrepare

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über