SisRestoredLink fonction)

La fonction SisRestoredLink retourne le nom du ou des fichiers du magasin commun vers lequel pointe le lien SIS restauré spécifié.

Syntaxe

BOOL SisRestoredLink(
  _In_  PVOID  sisRestoreStructure,
  _In_  PWCHAR restoredFileName,
  _In_  PVOID  reparseData,
  _In_  ULONG  reparseDataSize,
  _Out_ PULONG countOfCommonStoreFilesToRestore,
  _Out_ PWCHAR **commonStoreFilesToRestore
);

Paramètres

sisRestoreStructure [ dans]

Pointeur vers une structure de restauration SIS retournée à partir de SisCreateRestoreStructure.

restoredFileName [ dans]

Nom de fichier complet du fichier de liaison SIS restauré.

reparseData [ dans]

Pointeur vers le contenu du point d’analyse SIS. Ce point d’analyse contient des données décrivant le lien SIS restauré. Pour récupérer les données du point d’analyse d’un fichier, utilisez le code de contrôle FSCTL _ obtenir le _ _ point d’analyse .

reparseDataSize [ dans]

Taille du contenu du point d’analyse SIS pointé par reparseData, en octets.

countOfCommonStoreFilesToRestore [ à]

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

commonStoreFilesToRestore [ à]

Pointeur vers un tableau de noms de fichiers Common-Store. 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.

Si la valeur du paramètre countOfCommonStoreFilesToRestore n’est pas 0, la valeur du paramètre commonStoreFilesToRestore contient les noms des fichiers du magasin commun à restaurer suite à la restauration du lien SIS. Si la valeur est 0, cela signifie que les fichiers du magasin commun ont été retournés une fois ou qu’ils sont déjà présents sur le volume.

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.

Remarques

Vous devez appeler cette fonction pour chaque lien SIS qui a été restauré.

Cette fonction renverra chaque fichier de magasin commun au plus une fois pour chaque opération de restauration. toute tentative de restauration de liens SIS supplémentaires qui affichent le même fichier de magasin commun n’entraîne pas le renvoi du nom de fichier du magasin commun.

Cette fonction ne retourne pas de fichier de magasin commun qui n’a pas également été retourné dans un appel à SisCSFilesToBackupForLink pendant l’opération de sauvegarde, en supposant que les données de réanalyse SIS stockées sur le média n’ont pas été endommagées.

Lors de la restauration d’un lien SIS, votre opération de restauration doit créer uniquement le fichier partiellement alloué approprié, initialiser toutes les plages allouées, puis écrire les données de nouvelle analyse SIS exactement telles qu’elles ont été lues pendant l’opération de sauvegarde. Il est essentiel que votre opération de restauration crée des fichiers partiellement alloués avec des plages non allouées, plutôt que des fichiers partiellement alloués (ou des fichiers non distants) initialisés avec des zéros.

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é.

Configuration requise

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

Voir aussi

SisCreateRestoreStructure

SisCSFilesToBackupForLink