DsRestoreRegisterComplete 関数

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

DsRestoreRegisterComplete 関数は、復元操作の完了後に Active Directory サーバーのロックを解除するために呼び出されます。この関数は、DsRestoreRegister 関数に対応します。

構文

HRESULT DsRestoreRegisterComplete(
  _In_ HBC     hbc,
  _In_ HRESULT hrRestoreState
);

hbc [in]: DsRestorePrepare 関数で取得した 復元コンテキストハンドルを 格納します。
hrRestoreState [in]: 復元操作の最終的な状態が含まれます。このパラメーターには、復元操作が成功した場合はS_OK、それ以外の場合はエラーコードが含まれている必要があります。

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

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

doメインコントローラーを再起動する前に、この関数を呼び出して復元操作の状態を指定します。状態が成功しなかった場合、ディレクトリサービスは有効なデータベースが復元されるまで開始されません。この関数は復元操作を完了し、Active Directory ドメインサービスを開始できるようにします。