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 |
|---|---|
|
Le nom du fichier qui contient les données de réponse a été récupéré. |
|
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 |