CertSrvRestoreRegisterThroughFile-Funktion (certbcli.h)

  • Artikel

Die CertSrvRestoreRegisterThroughFile-Funktion registriert eine Certificate Services-Wiederherstellung.

Syntax

HRESULT CERTBCLI_API CertSrvRestoreRegisterThroughFile(
  [in]           HCSBC            hbc,
  [in, optional] WCHAR const      *pwszCheckPointFilePath,
  [in, optional] WCHAR const      *pwszLogPath,
  [in, optional] CSEDB_RSTMAPW [] rgrstmap,
  [in]           LONG             crstmap,
  [in, optional] WCHAR const      *pwszBackupLogPath,
  [in]           ULONG            genLow,
  [in]           ULONG            genHigh
);

Parameter

[in] hbc

Ein Handle für den Wiederherstellungskontext der Zertifikatdienste. Dieses Handle wird durch Aufrufen der CertSrvRestorePrepare-Funktion abgerufen.

[in, optional] pwszCheckPointFilePath

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Wiederherstellungspfad für die Prüfpunktdatei enthält. Übergeben Sie NULL für diesen Parameter, wenn er nicht benötigt wird.

[in, optional] pwszLogPath

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die das aktuelle Protokolldateiverzeichnis enthält. Übergeben Sie NULL für diesen Parameter, wenn er nicht benötigt wird.

[in, optional] rgrstmap

Ein Array von CSEDB_RSTMAP Strukturen, das die Wiederherstellungszuordnung enthält. Wenn Sie eine vollständige Datenbankwiederherstellung durchführen, gibt dieser Parameter den Namen der Sicherungsdatenbank sowie einen neuen Namen für die Datenbank an, nachdem sie wiederhergestellt wurde. Auf den Namen der Sicherungsdatenbank wird vom pwszDatabaseName-Member verwiesen, und auf den neuen Datenbanknamen wird vom pwszNewDatabaseName-Member verwiesen. Wenn die Absicht darin besteht, denselben Namen sowohl für die Sicherungsdatenbank als auch für die wiederhergestellte Datenbank beizubehalten, legen Sie sowohl die pwszNewDatabaseName - als auch die pwszDatabaseName-Member auf denselben Namen fest. Der Name der Sicherungsdatenbank wird aus dem Pfad erstellt, der vom Aufruf des Sicherungsclients an die Funktion CertSrvRestoreGetDatabaseLocations zurückgegeben wird. CertSrvRestoreGetDatabaseLocations wäre während einer vollständigen Sicherung aufgerufen worden, und der Sicherungsclient hätte den zurückgegebenen Pfad gespeichert.

Wenn Sie eine inkrementelle Wiederherstellung durchführen, legen Sie diesen Parameter auf NULL fest.

[in] crstmap

Die Anzahl der Elemente im rgrstmap-Array . Legen Sie diesen Wert auf einen fest, wenn Sie eine vollständige Wiederherstellung durchführen, oder null, wenn Sie eine inkrementelle Wiederherstellung durchführen.

[in, optional] pwszBackupLogPath

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Pfad für das Sicherungsprotokollverzeichnis enthält. Übergeben Sie NULL für diesen Parameter, wenn er nicht benötigt wird.

[in] genLow

Die niedrigste Protokollnummer, die in dieser Wiederherstellungssitzung wiederhergestellt wurde. Protokolldateien haben die Form von edbXXXXX.log, wobei XXXXX ein Fünf-Hexadezimalwert ist. Beispielsweise ist edb00001.log die erste Protokolldatei, die von der internen Datenbank erstellt wurde. Für diese Funktion entspricht ein Wert von 1 in genLow der Protokolldatei edb00001.log.

[in] genHigh

Die höchste Protokollnummer, die in dieser Wiederherstellungssitzung wiederhergestellt wurde.

Rückgabewert

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

Hinweise

Diese Funktion ist mit der Funktion CertSrvRestoreRegister identisch, mit der Ausnahme, dass CertSrvRestoreRegister erfordert, dass das aufrufende Konto ein lokaler Administrator ist. Die CertSrvRestoreRegisterThroughFile-Funktion erfordert nur, dass das aufrufende Konto über die Wiederherstellungsberechtigung verfügt.

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 (include Certsrv.h)
Bibliothek Certadm.lib
DLL Certadm.dll

Weitere Informationen

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste