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
S_OK * * * * *
Succès
E_INVALIDARG
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
Deliveryoptimization. h
MIDL
DeliveryOptimization. idl
Bibliothèque
Dosvc. lib
DLL
Dosvc.dll
IID
IID_IBackgroundCopyFile2 est défini en tant que 83e81b93-0873-474d-8A8C-f2018b1a939c

Voir aussi

IBackgroundCopyFile2