Méthode IBackgroundCopyFile2::SetRemoteName
Remplace le nom distant par une nouvelle URL dans un travail de téléchargement.
Syntaxe
HRESULT SetRemoteName(
[in] LPCWSTR RemoteName
);
Paramètres
-
RemoteName [in]
-
Chaîne terminée par null qui contient le nom du fichier sur le serveur. Pour plus d’informations sur la spécification du nom distant, consultez le membre RemoteName .
Valeur retournée
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). |
Notes
En règle générale, 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 du fichier.
Cette méthode ne sérialise pas lorsqu’elle est retournée. Pour sérialiser la modification, suspendez le travail, appelez cette méthode (si vous modifiez plusieurs fichiers dans le travail, utilisez une boucle) et reprenez le travail. L’appel de la méthode IBackgroundCopyJob::Resume sérialise la modification.
Si l’horodatage ou la taille du fichier du nouveau nom distant est différente du nom distant précédent ou si le nouveau serveur ne prend pas en charge la reprise du point de contrôle (pour les noms distants HTTP), l’optimisation de la distribution redémarre le téléchargement. Sinon, le transfert reprend à partir de la même position sur le nouveau serveur. L’optimisation de la distribution ne redémarre pas les fichiers déjà transférés.
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows 10, version 1709 [applications de bureau uniquement] |
Serveur minimal pris en charge |
Windows Server, version 1709 [applications de bureau uniquement] |
En-tête |
|
IDL |
|
Bibliothèque |
|
DLL |
|
IID |
IID_IBackgroundCopyFile2 est défini comme 83e81b93-0873-474d-8a8c-f2018b1a939c |