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

Article
02/23/2024

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