Structure FILESETINFO (qmgr.h)

[Le Gestionnaire de files d’attente (QMGR) est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt le service de transfert intelligent en arrière-plan (BITS).]

La structure FILESETINFO identifie les noms distants et locaux du fichier à télécharger.

Syntaxe

typedef struct _FILESETINFO {
  BSTR  bstrRemoteFile;
  BSTR  bstrLocalFile;
  DWORD dwSizeHint;
} FILESETINFO;

Membres

bstrRemoteFile

Chaîne terminée par null qui contient le nom du fichier sur le serveur (par exemple, http://ServerName Path//FileName.ext). Le format du nom doit être conforme au protocole de transfert que vous utilisez. Vous ne pouvez pas utiliser de caractères génériques dans le chemin d’accès ou le nom de fichier. L’URL ne doit contenir que des caractères d’URL légaux ; aucun traitement d’échappement n’est effectué. L’URL est limitée à 2 200 caractères, sans compter le caractère null de fin.

bstrLocalFile

Chaîne terminée par null qui contient le nom du fichier sur le client. Le nom de fichier doit inclure le chemin d’accès complet, par exemple, D :\MyApp\UpdatesName FileName\.ext. 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 du chemin doivent exister. Le chemin d’accès est limité à MAX_PATH, sans inclure le caractère null de fin. L’utilisateur doit avoir l’autorisation d’écrire dans le répertoire local pour les téléchargements et les chargements qui demandent une réponse. BITS ne prend pas en charge les flux NTFS. Au lieu d’utiliser des lecteurs réseau, qui sont spécifiques à une session, utilisez des chemins UNC (par exemple, \ServerName\ShareName\Path\FileName.ext).

dwSizeHint

Non pris en charge.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
En-tête	qmgr.h