Funzione CertSrvRestoreRegisterThroughFile (certbcli.h)
La funzione CertSrvRestoreRegisterThroughFile registra un ripristino di Servizi certificati.
Sintassi
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
);
Parametri
[in] hbc
Handle per il contesto di ripristino di Servizi certificati. Questo handle viene ottenuto chiamando la funzione CertSrvRestorePrepare .
[in, optional] pwszCheckPointFilePath
Puntatore a una stringa Unicode con terminazione Null che contiene il percorso di ripristino per il file del punto di controllo. Se non è necessario, passare NULL per questo parametro.
[in, optional] pwszLogPath
Puntatore a una stringa Unicode con terminazione Null che contiene la directory del file di log corrente. Se non è necessario, passare NULL per questo parametro.
[in, optional] rgrstmap
Matrice di strutture CSEDB_RSTMAP che contiene la mappa di ripristino. Se si esegue un ripristino completo del database, questo parametro specifica il nome del database di backup, nonché un nuovo nome per il database dopo il ripristino. Il nome del database di backup viene fatto riferimento dal membro pwszDatabaseName e viene fatto riferimento al nuovo nome del database dal membro pwszNewDatabaseName . Se lo scopo è mantenere lo stesso nome sia per il database di backup che per il database ripristinato, impostare sia i membri pwszNewDatabaseName che pwszDatabaseName sullo stesso nome. Il nome del database di backup viene costruito dal percorso restituito dalla chiamata del client di backup alla funzione CertSrvRestoreGetDatabaseLocations . CertSrvRestoreGetDatabaseLocations sarebbe stato chiamato durante un backup completo e il client di backup avrebbe salvato il percorso restituito.
Se si esegue un ripristino incrementale, impostare questo parametro su NULL.
[in] crstmap
Numero di elementi nella matrice rgrstmap . Impostare questo valore su uno se si esegue un ripristino completo o zero se si esegue un ripristino incrementale.
[in, optional] pwszBackupLogPath
Puntatore a una stringa Unicode con terminazione Null che contiene il percorso della directory del log di backup. Se non è necessario, passare NULL per questo parametro.
[in] genLow
Numero di log più basso ripristinato in questa sessione di ripristino. I file di log sono sotto forma di edbXXXXX.log, dove XXXXX è un valore di cinque cifre esadecimali. Ad esempio, edb00001.log è il primo file di log creato dal database interno. Ai fini di questa funzione, il valore 1 in genLow corrisponde al file di log edb00001.log.
[in] genHigh
Numero di log più alto ripristinato in questa sessione di ripristino.
Valore restituito
Il valore restituito è HRESULT. Il valore S_OK indica l'esito positivo.
Commenti
Questa funzione è identica alla funzione CertSrvRestoreRegister , ad eccezione del fatto che CertSrvRestoreRegister richiede che l'account chiamante sia un amministratore locale. La funzione CertSrvRestoreRegisterThroughFile richiede solo che l'account chiamante abbia il privilegio di ripristino.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Nessuno supportato |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | certbcli.h (include Certsrv.h) |
Libreria | Certadm.lib |
DLL | Certadm.dll |
Vedi anche
CertSrvRestoreRegisterComplete
Uso delle funzioni di backup e ripristino dei servizi certificati