SisCSFilesToBackupForLink fonction)

La fonction SisCSFilesToBackupForLink retourne des informations décrivant les fichiers de magasin commun vers lesquels 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 [ dans]

Pointeur vers la structure de sauvegarde SIS retournée par SisCreateBackupStructure.

reparseData [ dans]

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

thisFileContext [ à]

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é, affectez la valeur null à ce paramètre. La valeur de ce paramètre ne sera pas traitée dans ce cas.

matchingFileContext [ à]

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 une chaîne de contexte n’est pas fournie comme valeur du paramètre thisFileContext , affectez la valeur null à ce paramètre. La valeur de ce paramètre ne sera pas traitée dans ce cas.

countOfCommonStoreFilesToBackUp [ à]

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

commonStoreFilesToBackUp [ à]

Pointeur vers un tableau de noms de fichiers. Ces fichiers doivent être sauvegardés en même temps et de la même façon que les fichiers du magasin commun demandés par SisCreateBackupStructure.

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

L’application de sauvegarde ne doit appeler cette fonction qu’une seule fois pour chaque fichier de liaison SIS en cours de sauvegarde.

L’application de sauvegarde peut identifier un point d’analyse SIS par sa balise, la balise d’analyse d’e/s de _ _ balise _ 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 commonStoreFilesToBackUp de chaînes avec les noms du ou des fichiers du magasin commun qui doivent être sauvegardés (e). Dans le cas contraire, 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 affecte à la valeur du paramètre countOfCommonStoreFilesToBackUp la valeur 0. S’il existe plusieurs fichiers de magasin commun correspondant au lien spécifié, la valeur du paramètre thisFileContext est la chaîne de contexte correspondant au premier fichier de magasin commun retourné dans le tableau qui est, commonStoreFilesToBackUp [ 0 ] .

La version actuelle de cette fonction retournera au plus un fichier de magasin commun, mais il est possible que dans les versions ultérieures, un seul lien puisse être sauvegardé par plusieurs fichiers du magasin commun, par exemple, un pour chaque flux du fichier afin que votre application de sauvegarde prenne en charge plusieurs fichiers dans chaque appel à cette fonction. Dans tous les cas, chaque fichier de magasin commun est retourné au plus une fois pour chaque passe de sauvegarde.

Votre application de sauvegarde doit sauvegarder ou restaurer le ou les fichiers du magasin commun identifiés par le nom de fichier ou les noms de fichiers retournés dans le paramètre commonStoreFilesToBackUp . Qu’il y ait ou non un fichier de magasin commun, votre application de sauvegarde doit sauvegarder le fichier de liaison SIS tel qu’il existe sur le disque, par exemple, comme un point d’analyse et un fichier partiellement alloué, et probablement sans aucune plage remplie. Votre application de sauvegarde peut sauvegarder ou restaurer le ou les fichiers du magasin commun immédiatement, les différer ou les combiner en fonction des besoins.

Une fois l’opération de sauvegarde terminée, Désallouez la mémoire utilisée par le tableau de chaînes commonStoreFilesToBackUp en appelant SisFreeAllocatedMemory.

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

SisFreeAllocatedMemory

SisCreateBackupStructure