IBackgroundCopyFile2 :: SetRemoteName, méthode
Remplace le nom distant par une nouvelle URL dans un travail de téléchargement.
Syntaxe
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
Paramètres
-
Nom_distant [ dans]
-
Chaîne terminée par le caractère null qui contient le nom du fichier sur le serveur. Pour plus d’informations sur la spécification du nom distant, consultez le membre nom_distant .
Valeur de retour
Cette méthode retourne les valeurs de retour suivantes, ainsi que d’autres.
| Code de retour | Description |
|---|---|
|
Succès |
|
Le nouveau nom distant est une URL non valide ou la nouvelle URL est trop longue (l’URL ne peut pas dépasser 2 200 caractères). |
Remarques
En général, vous appelez cette méthode si vous souhaitez modifier l’URL utilisée pour transférer le fichier ou si vous souhaitez modifier le nom ou le chemin d’accès du fichier.
Cette méthode ne sérialise pas quand elle retourne. Pour sérialiser la modification, interrompez la tâche, appelez cette méthode (si vous modifiez plusieurs fichiers du travail, utilisez une boucle) et reprenez la tâche. L’appel de la méthode méthode ibackgroundcopyjob :: Resume sérialise la modification.
Si l’horodatage ou la taille de fichier du nouveau nom distant est différent du nom distant précédent ou si le nouveau serveur ne prend pas en charge la reprise de point de contrôle (pour les noms distants HTTP), l’optimisation de la remise redémarre le téléchargement. Dans le cas contraire, le transfert reprend à partir de la même position sur le nouveau serveur. L’optimisation de la remise ne redémarre pas les fichiers déjà transférés.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 10, les applications de bureau version 1709 [ uniquement] |
| Serveur minimal pris en charge |
Windows Serveur, version 1709 [ applications de bureau uniquement] |
| En-tête |
|
| MIDL |
|
| Bibliothèque |
|
| DLL |
|
| IID |
IID_IBackgroundCopyFile2 est défini en tant que 83e81b93-0873-474d-8A8C-f2018b1a939c |