Skip to main content

Méthode IXtfCopyFileCallback::OnFileCopyProgress

Appelée lorsque la progression d’une copie de fichier change.

Syntaxe

Paramètres

pszSrcFileName
Type : LPCWSTR
Pointeur vers le nom du fichier source. Ce paramètre est déprécié et sa valeur est maintenant une copie de pszDstFileName. pszDstFileName
Type : LPCWSTR
Pointeur vers le nom du fichier cible. ullFileSize
Type : ULONGLONG
Taille totale du fichier source, en octets. ullBytesCopied
Type : ULONGLONG
Nombre d’octets du fichier copiés jusqu’à présent.

Valeur de retour

Type : HRESULT Retourne S_OK en cas de réussite; sinon, retourne un code d’erreur HRESULT.

Remarques

Cette fonction est appelée par la méthode IXtfFileIOClient::CopyFiles pour chaque paquet transféré pendant l’opération de copie de fichiers. L’appel initial à IXtfCopyFileCallback::OnFileCopyProgress pour un fichier spécifie 0 octet dans ullBytesCopied et MAX_FILE_SIZE octets dans ullFileSize. Cet appel initial indique que vous avez commencé à copier un nouveau fichier. Vous pouvez ensuite utiliser les informations de fichier spécifiées dans les appels subséquents à IXtfCopyFileCallback::OnFileCopyProgress pour suivre et afficher la progression de l’opération de copie de fichiers. Si cette fonction de rappel retourne un code d’erreur HRESULT, l’opération de copie de fichiers est abandonnée.

Configuration requise

En-tête : xtffileio.h Bibliothèque : xtffileio.lib Plateformes prises en charge : Windows (pour les outils de console XBOX)

Voir aussi

Interface IXtfCopyFileCallback
XtfFileIO
Last modified on October 6, 2026