SisCreateRestoreStructure fonction)

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 [ dans]

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 pas « C : \ ». Le volume ne peut pas être le volume système ou de démarrage.

sisRestoreStructure [ à]

Structure de restauration SIS retournée. Cette structure doit être traitée comme opaque par l’appelant.

commonStoreRootPathname [ à]

Nom de chemin d’accès complet du magasin commun du volume spécifié. Par exemple, « c : \ SIS Common Store ».

countOfCommonStoreFilesToRestore [ à]

Nombre de fichiers listés dans le paramètre commonStoreFilesToRestore .

commonStoreFilesToRestore [ à]

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 façon que les fichiers du magasin commun demandés par SisCSFilesToBackupForLink.

Valeur retournée

Cette fonction retourne la valeur true si elle se termine avec succès et la valeur 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 du magasin commun qui correspondent à un ensemble de liens SIS sur le support de sauvegarde si ces fichiers ou fichiers du magasin commun existent toujours sur le disque. Le contenu du flux de données d’un fichier du magasin commun n’est jamais modifié une fois qu’il a été 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 Common-Store 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 SIS que 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Applications de [ Bureau Windows XP uniquement]
Serveur minimal pris en charge
Applications de bureau Windows Server 2003 [ uniquement]
En-tête
Sisbkup. h
Bibliothèque
Sisbkup. lib
DLL
Sisbkup.dll

Voir aussi

SisCreateBackupStructure

SisCSFilesToBackupForLink

SisFreeAllocatedMemory

SisFreeBackupStructure