Fonction CertSrvRestoreRegisterThroughFile (certbcli.h)
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
CertSrvRestoreRegisterComplete
Utilisation des fonctions de sauvegarde et de restauration des services de certificat