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

こちらもご覧ください

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

証明書サービスのバックアップと復元の機能の使用