DsRestoreRegister fonction)

[Cette fonction peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. à partir de Windows Vista, utilisez Service VSS (VSS) à la place.]

La fonction DsRestoreRegister enregistre une opération de restauration. Cette fonction interverrouille toutes les opérations de restauration ultérieures et empêche le démarrage de la cible de restauration jusqu’à ce que la fonction DsRestoreRegisterComplete soit appelée.

Syntaxe

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
);

Paramètres

Hbc [ dans]

Contient le descripteur de contexte de restauration obtenu avec la fonction DsRestorePrepare .

szCheckPointFilePath [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui contient le chemin d’accès au fichier de point de contrôle. Ce chemin d’accès est fourni par la fonction DsRestoreGetDatabaseLocations et a une valeur BFT de BFT _ Checkpoint _ dir. En général, il est identique au chemin d’accès de la base de données système. Ce chemin d’accès est requis pour la fonction de restauration de sauvegarde appropriée. Ce paramètre ne peut pas être null. Le passage de null dans ce paramètre entraîne une erreur pendant le processus de restauration.

szLogPath [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui contient le chemin d’accès où les fichiers journaux seront restaurés. Ce chemin d’accès est fourni par la fonction DsRestoreGetDatabaseLocations et a la valeur BFT BFT _ log _ dir. Si le chemin d’accès pointe vers un répertoire vide, de nouveaux fichiers journaux y sont créés. Ce paramètre ne peut pas être null.

rgrstmap [ dans]

Tableau de structures _ RSTMAP edb qui contient les chemins d’accès anciens et nouveaux pour chaque base de données. Il existe une structure pour chaque base de données. Pour le répertoire, il existe une structure pour la base de données système et une autre structure pour la base de données d’annuaire. L’ordre des éléments dans le tableau n’a pas d’importance. Le paramètre crstmap contient le nombre d’éléments dans le tableau.

crstmap [ dans]

Contient le nombre d’éléments dans le tableau rgrstmap .

szBackupLogPath [ dans]

Pointeur vers une chaîne se terminant par un caractère null qui contient le chemin d’accès de l’emplacement où les fichiers journaux sauvegardés résident actuellement. Ce paramètre ne peut pas être null.

genLow [ dans]

Contient le numéro de journal le plus bas à restaurer dans cette session de restauration. Il s’agit d’un nombre hexadécimal compris entre 0x00000 et 0xFFFFF.

genHigh [ dans]

Contient le numéro de journal le plus élevé à restaurer dans cette session de restauration. Il s’agit d’un nombre hexadécimal compris entre 0x00000 et 0xFFFFF.

Valeur retournée

Retourne S _ OK si la fonction réussit ou un code d’erreur Win32 ou RPC dans le cas contraire. La liste suivante répertorie les codes d’erreur possibles.

ERREUR d' _ accès _ refusé

L’appelant ne dispose pas des privilèges d’accès appropriés pour appeler cette fonction. La fonction DsSetAuthIdentity peut être utilisée pour définir les informations d’identification à utiliser pour les fonctions de sauvegarde et de restauration.

paramètre d’erreur _ non valide _

Un ou plusieurs paramètres ne sont pas valides.

hrMissingExpiryToken

Le jeton d’expiration fourni à DsRestorePrepare n’était pas valide. Cette valeur est définie dans ntdsbmsg. h.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Ntdsbcli. h
Bibliothèque
Ntdsbcli. lib
DLL
Ntdsbcli.dll
Noms Unicode et ANSI
DsRestoreRegisterW (Unicode) et DsRestoreRegisterA (ANSI)

Voir aussi

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

_RSTMAP edb

Restauration d’Active Directory

Fonctions de sauvegarde d’annuaire