Partager via

Méthode IBackgroundCopyFile3 ::GetTemporaryName (bits3_0.h)

  • Article

Obtient le chemin d’accès complet du fichier temporaire qui contient le contenu du téléchargement.

Syntaxe

HRESULT GetTemporaryName(
  [out] LPWSTR *pFilename
);

Paramètres

[out] pFilename

Chaîne terminée par null qui contient le chemin d’accès complet du fichier temporaire. Appelez la fonction CoTaskMemFree pour libérer ppFileName lorsque vous avez terminé.

Valeur retournée

La méthode retourne les valeurs de retour suivantes.

Code de retour Description
S_OK
 Succès

Remarques

Les applications peuvent utiliser cette méthode pour accéder aux données avant la fin du travail. Ouvrez le fichier pour l’accès en écriture partagé (FILE_SHARE_WRITE). Pour déterminer le nombre d’octets qui ont été transférés et sont disponibles pour la lecture, appelez la méthode IBackgroundCopyFile ::GetProgress . Notez que les informations de progression seront rétablies à zéro si l’horodatage de l’URL change.

N’ouvrez pas le fichier pour lecture tant que BITS n’a pas commencé à transférer le fichier ; sinon, le travail passe à l’état d’erreur temporaire.

Le fichier temporaire est disponible jusqu’à ce que l’application appelle la méthode IBackgroundCopyJob ::Complete ou IBackgroundCopyJob ::Cancel , ou que la stratégie de groupe JobInactivityTimeout expire. Vous devez libérer votre handle dans le fichier temporaire avant d’appeler la méthode Complete ou Cancel .

La liste de contrôle d’accès pour le fichier temporaire est la même que celle du fichier final lorsque Complete est appelé (la liste de contrôle d’accès est héritée du dossier).

Pour déterminer si BITS a terminé le transfert du fichier, vous pouvez :

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête bits3_0.h (include Bits.h)
Bibliothèque Bits.lib

Voir aussi

IBackgroundCopyCallback2 ::FileTransferred

IBackgroundCopyFile3