IBackgroundCopyFile::GetRemoteName 方法 (bits.h)

检索文件的远程名称。

语法

HRESULT GetRemoteName(
  [out] LPWSTR *pVal
);

参数

[out] pVal

以 Null 结尾的字符串,其中包含要传输的文件的远程名称。 该名称是完全限定的。 完成后,调用 CoTaskMemFree 函数以释放 ppName

返回值

此方法在成功时返回 S_OK 或错误时返回标准 COM HRESULT 值之一。

注解

调用 IBackgroundCopyJob 接口的 AddFileAddFileSet 方法时,将设置远程文件名。

若要更改远程文件名,请调用 IBackgroundCopyFile2::SetRemoteName 方法或 IBackgroundCopyJob3::ReplaceRemotePrefix 方法。

示例

请参阅 IBackgroundCopyFile::GetLocalName 方法的示例代码。

要求

要求
最低受支持的客户端 Windows XP
最低受支持的服务器 Windows Server 2003
目标平台 Windows
标头 bits.h
Library Bits.lib
DLL QmgrPrxy.dll

另请参阅

IBackgroundCopyFile

IBackgroundCopyFile::GetLocalName

IBackgroundCopyJob::AddFile

IBackgroundCopyJob::AddFileSet