次の方法で共有

DsRestoreRegister 関数

  • [アーティクル]

[この関数は、[要件] セクションで指定されたオペレーティング システムで使用できます。 それより後のバージョンでは、変更されるか、使用できなくなる場合があります。 Windows Vista 以降では、代わりにボリューム シャドウ コピー サービス (VSS) を使用します。

DsRestoreRegister 関数は復元操作を登録します。この関数は、後続のすべての復元操作をインターロックし、DsRestoreRegisterComplete 関数が呼び出されるまで復元ターゲットが開始されないようにします。

構文

HRESULT DsRestoreRegister(
  _In_ HBC        hbc,
  _In_ LPCTSTR    szCheckPointFilePath,
  _In_ LPCTSTR    szLogPath,
  _In_ EDB_RSTMAP rgrstmap[],
  _In_ LONG       crstmap,
  _In_ LPCTSTR    szBackupLogPath,
  _In_ ULONG      genLow,
  _In_ ULONG      genHigh
);

パラメーター

hbc [in]

DsRestorePrepare 関数で取得した 復元コンテキスト ハンドルを 格納します。

szCheckPointFilePath [in]

チェックpoint ファイルへのパスを含む null で終わる文字列へのポインター。 このパスは DsRestoreGetDatabaseLocations 関数によって提供され、BFT 値は BFT_CHECKPOINT_DIR。 通常、これはシステム データベース パスと同じです。 このパスは、適切なバックアップ復元機能に必要です。 このパラメーターを NULL にすることはできません。 このパラメーターに NULL を渡すと、復元プロセス中にエラーが発生します。

szLogPath [in]

ログ ファイルが復元されるパスを含む null で終わる文字列へのポインター。 このパスは DsRestoreGetDatabaseLocations 関数によって提供され、BFT 値は BFT_LOG_DIR。 パスが空のディレクトリを指している場合は、そこに新しいログ ファイルが作成されます。 このパラメーターを NULL にすることはできません。

rgrstmap [in]

各データベースの 古いパスと新しいパスを含むEDB_RSTMAP 構造体の配列。 データベースごとに 1 つの構造があります。 ディレクトリには、システム データベースの構造と、ディレクトリ データベース用の別の構造があります。 配列内の要素の順序は関係ありません。 crstmap パラメーターには、配列内の要素の数が含まれています。

crstmap [in]

rgrstmap 配列内の要素の数を格納します。

szBackupLogPath [in]

バックアップされたログ ファイルが現在存在するパスを含む null で終わる文字列へのポインター。 このパラメーターを NULL にすることはできません。

genLow [in]

この復元セッションで復元する最小のログ番号が含まれています。 これは、0x00000から0xFFFFFまでの範囲の 16 進数です。

genHigh [in]

この復元セッションで復元する最大のログ番号が含まれています。 これは、0x00000から0xFFFFFまでの範囲の 16 進数です。

戻り値

関数が 成功した場合はS_OK を返し、それ以外の場合は Win32 または RPC エラー コードを返します。 考えられるエラー コードの一覧を次に示します。

ERROR_ACCESS_DENIED

呼び出し元には、この関数を呼び出す適切なアクセス特権がありません。 DsSetAuthIdentity 関数を使用して、バックアップおよび復元関数に使用する資格情報を設定できます。

ERROR_INVALID_PARAMETER

1 つ以上のパラメーターが無効です。

hrMissingExpiryToken

DsRestorePrepare に指定された有効期限トークンが無効でした。 この値は Ntdsbmsg.h で定義されています。

要件

要件 Value
サポートされている最小のクライアント
 Windows Vista
サポートされている最小のサーバー
 Windows Server 2008
ヘッダー
Ntdsbcli.h
ライブラリ
Ntdsbcli.lib
[DLL]
Ntdsbcli.dll
Unicode 名と ANSI 名
 DsRestoreRegisterW (Unicode) と DsRestoreRegisterA (ANSI)

関連項目

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

Active Directory の復元

ディレクトリ バックアップ関数