Fonction SisCreateRestoreStructure
La fonction SisCreateRestoreStructure crée une structure de restauration SIS basée sur les informations fournies.
Syntaxe
BOOL SisCreateRestoreStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisRestoreStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToRestore,
_Out_ PWCHAR **commonStoreFilesToRestore
);
Paramètres
-
volumeRoot [in]
-
Nom de fichier de la racine du volume, sans la barre oblique inverse de fin, du volume à sauvegarder. Par exemple, spécifiez « C: » et non « C:\ ». Le volume ne peut pas être le volume système ou de démarrage.
-
sisRestoreStructure [out]
-
Structure de restauration SIS retournée. Cette structure doit être traitée comme opaque par l’appelant.
-
commonStoreRootPathname [out]
-
Nom complet du chemin d’accès complet du magasin commun du volume spécifié. Par exemple, « c:\SIS Common Store ».
-
countOfCommonStoreFilesToRestore [out]
-
Nombre de fichiers répertoriés dans le paramètre commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Pointeur vers un tableau de noms de fichiers qui spécifie la liste des fichiers internes utilisés par SIS pour gérer le volume spécifié. Ces fichiers doivent être restaurés en même temps et de la même manière que les fichiers courants demandés par SisCSFilesToBackupForLink.
Valeur retournée
Cette fonction retourne TRUE si elle se termine correctement et FALSE dans le cas contraire. Appelez GetLastError pour obtenir plus d’informations sur la raison de l’échec de l’appel.
Notes
Cette fonction établit l’environnement de restauration sur le volume spécifié de la façon dont SisCreateBackupStructure établit l’environnement de sauvegarde sur le volume spécifié.
Notez que cette fonction n’identifie pas nécessairement le ou les fichiers de magasin commun correspondant à un ensemble de liens SIS sur le support de sauvegarde si ces fichiers de magasin communs existent toujours sur le disque. Le contenu du flux de données d’un fichier de magasin commun ne change jamais une fois qu’il est créé. Par conséquent, si le fichier existe déjà sur le disque, il n’est pas nécessaire de le restaurer.
Les noms de fichiers courants sont globalement uniques pour garantir l’intégrité de l’opération de restauration même si elle ne se produit pas sur le même volume avec SIS auquel l’opération de sauvegarde a accédé.
Une fois l’opération de restauration terminée, libérez la mémoire utilisée par le tableau de chaînes commonStoreFilesToRestore en appelant SisFreeAllocatedMemory.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|