CertSrvRestoreRegisterThroughFile 函式 (certbcli.h)
CertSrvRestoreRegisterThroughFile 函式會註冊憑證服務還原。
語法
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
);
參數
[in] hbc
憑證服務還原內容的句柄。 呼叫 CertSrvRestorePrepare 函式可取得此句柄。
[in, optional] pwszCheckPointFilePath
Null 終止 Unicode 字串的指標，其中包含檢查點檔案的還原路徑。 如果不需要此參數，請傳遞 NULL 。
[in, optional] pwszLogPath
包含目前記錄檔目錄之 Null 終止 Unicode 字串的指標。 如果不需要此參數，請傳遞 NULL 。
[in, optional] rgrstmap
包含還原對應的 CSEDB_RSTMAP 結構的陣列。 如果您要執行完整資料庫還原，此參數會指定備份資料庫的名稱，以及在還原資料庫之後為資料庫指定新的名稱。 備份資料庫名稱是由 pwszDatabaseName 成員所參考，而 pwszNewDatabaseName 成員會參考新的資料庫名稱。 如果意圖是維護備份資料庫和還原資料庫相同的名稱，請將 pwszNewDatabaseName 和 pwszDatabaseName 成員設定為相同的名稱。 備份資料庫名稱是從備份用戶端呼叫 CertSrvRestoreGetDatabaseLocations 函式所傳回的路徑建構。 CertSrvRestoreGetDatabaseLocations 會在完整備份期間呼叫，而備份用戶端會儲存傳回的路徑。
如果您要執行累加還原，請將此參數設定為 NULL。
[in] crstmap
rgrstmap 陣列中的項目數目。 如果您要執行完整還原，請將此值設定為 1，如果執行累加還原，請將此值設定為零。
[in, optional] pwszBackupLogPath
Null 終止的 Unicode 字串指標，其中包含備份記錄檔目錄的路徑。 如果不需要此參數，請傳遞 NULL 。
[in] genLow
在此還原會話中還原的最低記錄編號。 記錄檔的格式為 edbXXXXX.log，其中 XXXXX 是五個十六進位數位值。 例如，edb00001.log是內部資料庫所建立的第一個記錄檔。 為了達到此函式的目的， genLow 中的一個值會對應至記錄檔edb00001.log。
[in] genHigh
在此還原會話中還原的最高記錄編號。
傳回值
傳回值為 HRESULT。 值S_OK表示成功。
備註
此函式與 CertSrvRestoreRegister 函式相同，但 CertSrvRestoreRegister 要求呼叫帳戶必須是本機系統管理員。 CertSrvRestoreRegisterThroughFile 函式只需要呼叫帳戶具有還原許可權。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | certbcli.h (包含 Certsrv.h) |
| 程式庫 | Certadm.lib |
| Dll | Certadm.dll |