Partager via


Méthode IBackgroundCopyFile ::GetRemoteName (bits.h)

Récupère le nom distant du fichier.

Syntaxe

HRESULT GetRemoteName(
  [out] LPWSTR *pVal
);

Paramètres

[out] pVal

Chaîne terminée par null qui contient le nom distant du fichier à transférer. Le nom est complet. Appelez la fonction CoTaskMemFree pour libérer ppName lorsque vous avez terminé.

Valeur retournée

Cette méthode retourne S_OK sur la réussite ou l’une des valeurs COM HRESULT standard en cas d’erreur.

Remarques

Le nom de fichier distant est défini lorsque vous appelez les méthodes AddFile ou AddFileSet de l’interface IBackgroundCopyJob .

Pour modifier le nom du fichier distant, appelez la méthode IBackgroundCopyFile2 ::SetRemoteName ou la méthode IBackgroundCopyJob3 ::ReplaceRemotePrefix .

Exemples

Consultez l’exemple de code de la méthode IBackgroundCopyFile ::GetLocalName .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Serveur minimal pris en charge Windows Server 2003
Plateforme cible Windows
En-tête bits.h
Bibliothèque Bits.lib
DLL QmgrPrxy.dll

Voir aussi

IBackgroundCopyFile

IBackgroundCopyFile ::GetLocalName

IBackgroundCopyJob ::AddFile

IBackgroundCopyJob ::AddFileSet