Fonction SisCSFilesToBackupForLink
La fonction SisCSFilesToBackupForLink retourne des informations décrivant les fichiers de magasin commun vers 2000 auxquels pointe le lien SIS spécifié.
Syntaxe
BOOL SisCSFilesToBackupForLink(
_In_ PVOID sisBackupStructure,
_In_ PVOID reparseData,
_In_ ULONG reparseDataSize,
_Out_ PVOID thisFileContext,
_Out_ PVOID *matchingFileContext,
_Out_ PULONG countOfCommonStoreFilesToBackUp,
_Out_ PWCHAR **commonStoreFilesToBackUp
);
Paramètres
-
sisBackupStructure [in]
-
Pointeur vers la structure de sauvegarde SIS retournée par SisCreateBackupStructure.
-
reparseData [in]
-
Pointeur vers le contenu du point d’analyse SIS. Ce point d’analyse contient des données décrivant un lien SIS. 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.
-
thisFileContext [out]
-
Pointeur vers une chaîne de contexte fournie par l’application de sauvegarde appelant cette fonction. Le contenu de cette chaîne de contenu est entièrement déterminé par cette application de sauvegarde et n’est pas interprété par l’API de sauvegarde SIS. Ce paramètre est facultatif ; S’il n’est pas utilisé, définissez la valeur de ce paramètre sur NULL. La valeur de ce paramètre n’est pas traitée dans ce cas.
-
matchingFileContext [out]
-
Pointeur doublement indirect vers la chaîne de contexte du lien SIS identifié par les informations passées dans les quatre premiers paramètres de cette fonction. Ce paramètre est facultatif ; si aucune chaîne de contexte n’est fournie comme valeur du paramètre thisFileContext , définissez la valeur de ce paramètre sur NULL. La valeur de ce paramètre n’est pas traitée dans ce cas.
-
countOfCommonStoreFilesToBackUp [out]
-
Nombre de fichiers répertoriés dans le paramètre commonStoreFilesToBackUp .
-
commonStoreFilesToBackUp [out]
-
Pointeur vers un tableau de noms de fichiers. Ces fichiers doivent être sauvegardés en même temps et de la même manière que les fichiers de magasin commun demandés par SisCreateBackupStructure.
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
L’application de sauvegarde ne doit appeler cette fonction qu’une seule fois pour chaque fichier de liaison SIS sauvegardé.
L’application de sauvegarde peut identifier un point d’analyse SIS par sa balise, IO_REPARSE_TAG_SIS. Cette balise est définie dans Winnt.h.
Si ce point d’analyse identifié par la valeur du paramètre reparseData décrit la première instance d’un fichier à sauvegarder, cette fonction retourne NULL comme valeur du paramètre matchingFileContext et initialise la valeur du tableau de chaînes commonStoreFilesToBackUp avec les noms du ou des fichiers à sauvegarder. Sinon, cette fonction définit la valeur du paramètre matchingFileContext sur la chaîne de contexte correspondant à la première instance du fichier spécifié et définit la valeur du paramètre countOfCommonStoreFilesToBackUp sur 0. S’il existe plusieurs fichiers common-store correspondant au lien spécifié, la valeur du paramètre thisFileContext est la chaîne de contexte correspondant au premier fichier common-store retourné dans le tableau, à savoir commonStoreFilesToBackUp[0].
La version actuelle de cette fonction retourne au plus un fichier de magasin commun, mais il est possible que dans les versions ultérieures, un lien unique puisse être soutenu par plusieurs fichiers de magasin commun, par exemple, un pour chaque flux dans le fichier, de sorte que votre application de sauvegarde doit prendre en charge plusieurs fichiers dans chaque appel à cette fonction. Dans tous les cas, chaque fichier de magasin commun est retourné au maximum une fois pour chaque passe de sauvegarde.
Votre application de sauvegarde doit sauvegarder ou restaurer le ou les fichiers de magasin commun identifiés par le nom de fichier ou les noms de fichiers retournés dans le paramètre commonStoreFilesToBackUp . Qu’il existe ou non un fichier de magasin commun correspondant, votre application de sauvegarde doit sauvegarder le fichier de liaison SIS tel qu’il existe sur le disque, par exemple, en tant que point d’analyse et fichier partiellement alloué, et probablement sans plage renseignée. Votre application de sauvegarde peut sauvegarder ou restaurer immédiatement le ou les fichiers communs, les reporter ou les combiner si nécessaire.
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 |
|