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

Vedi anche

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Uso delle funzioni di backup e ripristino dei servizi certificati