Méthode IBackgroundCopyJob2 ::SetReplyFileName (bits1_5.h)
Spécifie le nom du fichier à contenir les données de réponse de l’application serveur. Appelez cette méthode uniquement si le type du travail est BG_JOB_TYPE_UPLOAD_REPLY.
Syntaxe
HRESULT SetReplyFileName(
[in] LPCWSTR ReplyFileName
);
Paramètres
[in] ReplyFileName
Chaîne terminée par null qui contient le chemin d’accès complet au fichier de réponse. BITS génère le nom de fichier si ReplyFileNamePathSpec a la valeur NULL ou une chaîne vide. Vous ne pouvez pas utiliser de caractères génériques dans le chemin d’accès ou le nom de fichier, et les répertoires dans le chemin doivent exister. Le chemin d’accès est limité à MAX_PATH, à l’exception de la marque de fin Null. L’utilisateur doit disposer des autorisations nécessaires pour écrire dans le répertoire. BITS ne prend pas en charge les flux NTFS. Au lieu d’utiliser des lecteurs réseau spécifiques à la session, utilisez des chemins UNC (par exemple, \server\share\path\file). N’incluez pas le \ ? préfixe dans le chemin d’accès.
Valeur retournée
Cette méthode retourne les valeurs HRESULT suivantes, ainsi que d’autres.
| Code de retour | Description |
|---|---|
|
A correctement spécifié le nom du fichier à contenir les données de réponse. |
|
Vous ne pouvez pas modifier le nom du fichier de réponse après que BITS a commencé à transférer la réponse au client. BITS transfère la réponse au client si l’état est BG_JOB_STATE_TRANSFERRING et que le membre BytesTotal de la structure BG_JOB_REPLY_PROGRESS n’est pas BG_SIZE_UNKNOWN. |
|
L’utilisateur n’est pas autorisé à écrire dans le répertoire spécifié sur le client. |
|
Le nom du fichier de réponse n’est pas valide ou dépasse MAX_PATH. |
Remarques
BITS génère le nom de fichier si vous n’appelez pas la méthode SetReplyFileName avant d’appeler la méthode IBackgroundCopyJob ::Resume pour la première fois.
Si BITS génère le nom de fichier, le fichier de réponse est écrit dans le même répertoire que le fichier de chargement local.
Vous pouvez appeler la méthode SetReplyFileName à tout moment avant que BITS commence à télécharger la réponse à partir de l’application serveur ; la méthode échoue si le téléchargement a commencé.
Le fichier de réponse est disponible pour le client après avoir appelé la méthode IBackgroundCopyJob ::Complete . Pour récupérer les données de réponse avant d’appeler la méthode Complete , appelez la méthode IBackgroundCopyJob2 ::GetReplyData .
Le fichier est vide si l’application serveur n’a pas fourni de réponse.
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 |