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 |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
DsRestoreRegisterW (Unicode) et DsRestoreRegisterA (ANSI) |