Fonction SisCreateBackupStructure
La fonction SisCreateBackupStructure crée une structure de sauvegarde SIS basée sur les informations fournies.
Syntaxe
BOOL SisCreateBackupStructure(
_In_ PWCHAR volumeRoot,
_Out_ PVOID *sisBackupStructure,
_Out_ PWCHAR *commonStoreRootPathname,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
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:\ ».
-
sisBackupStructure [out]
-
Structure de sauvegarde SIS retournée.
-
commonStoreRootPathname [out]
-
Nom complet du chemin d’accès complet du magasin commun du volume spécifié. Par exemple, « c:\SIS Common Store ».
-
countOfCommonStoreFilesToBackUp [out]
-
Nombre de fichiers répertoriés dans le paramètre commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Pointeur vers un tableau de noms de fichiers qui spécifie une liste de fichiers internes utilisés par SIS pour gérer le volume spécifié. Ces fichiers doivent être sauvegardé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 crée une structure de sauvegarde SIS, qui est utilisée par l’API de sauvegarde SIS pour créer et gérer une liste des liens de fichiers sur le volume et les fichiers d’origine vers lesquels les liens pointent. Cette fonction ne doit être appelée qu’une seule fois pour chaque volume avec SIS sauvegardé. Tous les fichiers du volume spécifié doivent être traités comme des fichiers de stockage courant et sauvegardés uniquement si SIS indique qu’ils doivent le faire.
Les paramètres countOfCommonStoreFilesToBackUp et commonStoreFilesToBackUp retournent ensemble une liste de fichiers qui doivent être sauvegardés, quels que soient les liens sauvegardés.
Si countOfCommonStoreFilesToBackUp a la valeur 0, commonStoreFilesToBackUp peut être un pointeur NULL . La valeur du paramètre commonStoreFilesToBackUp doit être ignorée.
Une fois l’opération de sauvegarde terminée, libérez la mémoire utilisée par le tableau de chaînes commonStoreFilesToBackUp 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 |
|