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
Certificate Services 復元コンテキストへのハンドル。 このハンドルは、 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、増分復元を実行する場合は 0 に設定します。
[in, optional] pwszBackupLogPath
バックアップ ログ ディレクトリのパスを含む null で終わる Unicode 文字列へのポインター。 このパラメーターが必要ない場合は、 NULL を 渡します。
[in] genLow
この復元セッションで復元された最小のログ番号。 ログ ファイルは edbXXXXX.log の形式で、XXXXX は 5 桁の 16 進数の値です。 たとえば、edb00001.logは内部データベースによって作成された最初のログ ファイルです。 この関数の場合、 genLow の 1 の値はログ ファイルのedb00001.logに対応します。
[in] genHigh
この復元セッションで復元された最も大きいログ番号。
戻り値
戻り値は HRESULT です。 S_OK の値は成功を示します。
注釈
この関数は CertSrvRestoreRegister 関数と同じですが、 CertSrvRestoreRegister では呼び出し元アカウントがローカル管理者である必要があります。 CertSrvRestoreRegisterThroughFile 関数では、呼び出し元アカウントに復元特権のみが必要です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | certbcli.h (Certsrv.h を含む) |
| Library | Certadm.lib |
| [DLL] | Certadm.dll |