Méthode IBackgroundCopyJob2 ::GetReplyFileName (bits1_5.h)

Récupère le nom du fichier qui contient les données de réponse de l’application serveur. Appelez cette méthode uniquement si le type de travail est BG_JOB_TYPE_UPLOAD_REPLY.

Syntaxe

HRESULT GetReplyFileName(
  [out] LPWSTR *pReplyFileName
);

Paramètres

[out] pReplyFileName

Chaîne terminée par null qui contient le chemin d’accès complet au fichier de réponse. Appelez la fonction CoTaskMemFree pour libérer pReplyFileName lorsque vous avez terminé.

Valeur retournée

Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.

Code de retour	Description
S_OK	Le nom du fichier qui contient les données de réponse a été récupéré.
E_NOTIMPL	Cette méthode n’est pas implémentée pour les travaux de type BG_JOB_TYPE_DOWNLOAD ou BG_JOB_TYPE_UPLOAD.

Remarques

Pour spécifier un nom de fichier de réponse, appelez la méthode IBackgroundCopyJob2 ::SetReplyFileName . Si vous n’avez pas spécifié de nom, la méthode GetReplyFileName retourne le nom que BITS a généré pour vous. Si vous n’avez pas spécifié de nom et que vous avez appelé cette méthode avant d’ajouter un fichier au travail, pReplyFileName est défini sur NULL.

Vous devez appeler la méthode IBackgroundCopyJob ::Complete avant d’ouvrir et de lire le fichier réponse ; le fichier de réponse n’est pas disponible pour le client tant que vous n’appelez pas la méthode Complete .

Le fichier est vide si l’application serveur n’a pas fourni de réponse.

Exemples

Pour obtenir un exemple qui utilise la méthode GetReplyFileName , consultez Récupération de la réponse à partir d’un travail Upload-Reply.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Windows
En-tête	bits1_5.h (include Bits.h)
Bibliothèque	Bits.lib
DLL	BitsPrx2.dll
Composant redistribuable	BITS 1.5 sur Windows XP

Voir aussi

IBackgroundCopyJob2 ::GetReplyData

IBackgroundCopyJob2 ::SetReplyFileName