Fonction CertSrvRestoreRegisterThroughFile (certbcli.h)

Article
08/22/2023

La fonction CertSrvRestoreRegisterThroughFile inscrit une restauration des services de certificat.

Syntaxe

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
);

Paramètres

[in] hbc

Handle du contexte de restauration des services de certificats. Ce handle est obtenu en appelant la fonction CertSrvRestorePrepare .

[in, optional] pwszCheckPointFilePath

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin de restauration du fichier de point case activée. Passez la valeur NULL pour ce paramètre s’il n’est pas nécessaire.

[in, optional] pwszLogPath

Pointeur vers une chaîne Unicode terminée par null qui contient le répertoire actuel du fichier journal. Passez la valeur NULL pour ce paramètre s’il n’est pas nécessaire.

[in, optional] rgrstmap

Tableau de structures CSEDB_RSTMAP qui contient la carte de restauration. Si vous effectuez une restauration complète de la base de données, ce paramètre spécifie le nom de la base de données de sauvegarde, ainsi qu’un nouveau nom pour la base de données après sa restauration. Le nom de la base de données de sauvegarde est référencé par le membre pwszDatabaseName , et le nouveau nom de base de données est référencé par le membre pwszNewDatabaseName . Si l’intention est de conserver le même nom pour la base de données de sauvegarde et la base de données restaurée, définissez les membres pwszNewDatabaseName et pwszDatabaseName sur le même nom. Le nom de la base de données de sauvegarde est construit à partir du chemin retourné par l’appel du client de sauvegarde à la fonction CertSrvRestoreGetDatabaseLocations . CertSrvRestoreGetDatabaseLocations aurait été appelé lors d’une sauvegarde complète, et le client de sauvegarde aurait enregistré le chemin retourné.

Si vous effectuez une restauration incrémentielle, définissez ce paramètre sur NULL.

[in] crstmap

Nombre d’éléments dans le tableau rgrstmap . Définissez cette valeur sur une si vous effectuez une restauration complète, ou zéro si vous effectuez une restauration incrémentielle.

[in, optional] pwszBackupLogPath

Pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès du répertoire du journal de sauvegarde. Passez la valeur NULL pour ce paramètre s’il n’est pas nécessaire.

[in] genLow

Numéro de journal le plus bas qui a été restauré dans cette session de restauration. Les fichiers journaux se présentent sous la forme de edbXXXXX.log, où XXXXX est une valeur hexadécimale à cinq chiffres. Par exemple, edb00001.log est le premier fichier journal créé par la base de données interne. Pour cette fonction, une valeur dans genLow correspond au fichier journal edb00001.log.

[in] genHigh

Numéro de journal le plus élevé qui a été restauré dans cette session de restauration.

Valeur retournée

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

Remarques

Cette fonction est identique à la fonction CertSrvRestoreRegister , sauf que CertSrvRestoreRegister exige que le compte appelant soit un administrateur local. La fonction CertSrvRestoreRegisterThroughFile exige uniquement que le compte appelant dispose du privilège de restauration.

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

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

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

Partager via