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 |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
| Unicode 名と ANSI 名 |
DsRestoreRegisterW (Unicode) と DsRestoreRegisterA (ANSI) |