Directory Services

DsRestoreRegisterComplete

The DsRestoreRegisterComplete function completes a restore operation.

HRESULT DsRestoreRegisterComplete(
  HBC hbc,
  HRESULT hrRestoreState
);

Parameters

hbc
[in] Indicates the client context handle of the restore.
hrRestoreState
[in] The status of the restore operation. You must set this parameter to hrNone if the restore is successful.

Return Values

One of the standard HRESULT success codes; otherwise, a failure code.

Remarks

Before you restart the domain controller, you must call this function to provide the status of the restore operation. If the status is not successful, the directory service will not start until a valid database has been restored. This function completes the restore operation and allows Active Directory to start.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Ntdsbcli.h.
Library: Use Ntdsbcli.lib.

See Also

Restoring Active Directory, Directory Backup Functions, DsRestorePrepare, DsRestoreGetDatabaseLocations, DsRestoreRegister, DsRestoreEnd