Fonction DsRestorePrepare
[Cette fonction est disponible pour une utilisation 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 plutôt le service VSS (Volume Shadow Copy Service ).
La fonction DsRestorePrepare se connecte au serveur d’annuaire spécifié et le prépare pour l’opération de restauration.
Syntaxe
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
Paramètres
-
szServerName [in]
-
Pointeur vers une chaîne terminée par null qui contient le nom du serveur à restaurer. Les barres obliques inverses précédentes sont facultatives. Le serveur doit être le même ordinateur à partir duquel cette fonction est appelée. Le nom du serveur ne peut pas contenir de caractères de soulignement (_). Un exemple de nom de serveur est « \\server1 ».
-
rtFlag [in]
-
Spécifie le type de restauration à effectuer. Il peut s’agir de zéro ou de l’une des valeurs suivantes.
-
RESTORE_TYPE_CATCHUP
-
Par défaut. La version restaurée est réconciliée via la logique de rapprochement standard afin que le DIT restauré puisse se synchroniser avec d’autres ordinateurs serveurs d’entreprise.
-
RESTORE_TYPE_AUTHORATATIVE
-
Non pris en charge.
-
RESTORE_TYPE_ONLINE
-
Non pris en charge. La restauration est effectuée lorsque NTDS est en ligne.
pvExpiryToken [in]
Pointeur vers le jeton d’expiration associé à la sauvegarde en cours de restauration. Ce jeton a été obtenu à partir de la fonction DsBackupPrepare lorsque le répertoire a été sauvegardé.
Si ce paramètre a la valeur NULL, le handle retourné dans phbc ne peut être utilisé que pour obtenir les répertoires de restauration avec la fonction DsRestoreGetDatabaseLocations . Le handle ne peut pas être utilisé pour d’autres fonctions de restauration.
cbExpiryTokenSize [in]
Contient la taille, en octets, du jeton d’expiration dans pvExpiryToken.
phbc [out]
Pointeur vers une valeur HBC qui reçoit le handle pour la restauration. Ce handle est utilisé lors de l’appel d’autres fonctions de restauration du service d’annuaire, telles que DsBackupOpenFile et DsRestoreEnd.
Valeur retournée
En cas de réussite, retourne un code HRESULT standard ; sinon, un code d’échec est retourné.
Notes
La fonction DsRestorePrepare nécessite que l’appelant soit membre du groupe Administrateurs sur le serveur.
DsRestorePrepare peut être utilisé avec ou sans jeton fourni. Si le jeton est fourni, il est vérifié pour expiration et toutes les opérations sont autorisées sur le contexte retourné. Si le jeton n’est pas fourni, le contexte retourné est restreint et peut être utilisé uniquement pour la fonction DsRestoreGetDatabaseLocations . Il ne peut pas être utilisé pour la fonction DsRestoreRegister .
Spécifications
| 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 |
DsRestorePrepareW (Unicode) et DsRestorePrepareA (ANSI) |