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

Article
02/23/2024

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
S_OK	A correctement spécifié le nom du fichier à contenir les données de réponse.
BG_E_INVALID_STATE	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.
E_ACCESSDENIED	L’utilisateur n’est pas autorisé à écrire dans le répertoire spécifié sur le client.
E_INVALIDARG	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

Voir aussi

IBackgroundCopyJob ::GetReplyData

IBackgroundCopyJob ::GetReplyFileName

Partager via