Fonction SisRestoredLink
La fonction SisRestoredLink retourne les noms du ou des fichiers de magasin commun pointés vers 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 [in]
-
Pointeur vers une structure de restauration SIS retournée par SisCreateRestoreStructure.
-
restoredFileName [in]
-
Nom de fichier complet du fichier de liaison SIS restauré.
-
reparseData [in]
-
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 de point d’analyse d’un fichier, utilisez le code de contrôle FSCTL_GET_REPARSE_POINT .
-
reparseDataSize [in]
-
Taille du contenu du point d’analyse SIS pointé vers reparseData, en octets.
-
countOfCommonStoreFilesToRestore [out]
-
Nombre de fichiers répertoriés dans le paramètre commonStoreFilesToRestore .
-
commonStoreFilesToRestore [out]
-
Pointeur vers un tableau de noms de fichiers communs. Ces fichiers doivent être restaurés en même temps et de la même manière que les fichiers de 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 common-store à restaurer à la suite de la restauration du lien SIS. Si la valeur est 0, les fichiers de magasin commun ont été retournés une seule fois, ou ils sont déjà présents sur le volume.
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
Vous devez appeler cette fonction pour chaque lien SIS qui a été restauré.
Cette fonction retourne chaque fichier de magasin commun au maximum une fois pour chaque opération de restauration ; toute tentative de restauration de liens SIS supplémentaires qui voient le même fichier de magasin commun n’entraîne pas le retour de ce nom de fichier de magasin commun.
Cette fonction ne retourne pas un fichier de magasin commun qui n’a pas été également retourné lors d’un appel à SisCSFilesToBackupForLink pendant l’opération de sauvegarde, en supposant que les données d’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 alloué approprié, initialiser toutes les plages allouées, puis écrire les données 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 alloués) initialisés avec des zéros.
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 ou fichiers de magasin commun 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 de magasin commun 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é.
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 |
|