检索文件的远程名称。
语法
HRESULT GetRemoteName(
[out] LPWSTR *pVal
);
参数
[out] pVal
以 Null 结尾的字符串，其中包含要传输的文件的远程名称。 该名称是完全限定的。 完成后，调用 CoTaskMemFree 函数以释放 ppName 。
返回值
此方法在成功时返回 S_OK 或错误时返回标准 COM HRESULT 值之一。
注解
调用 IBackgroundCopyJob 接口的 AddFile 或 AddFileSet 方法时，将设置远程文件名。
若要更改远程文件名，请调用 IBackgroundCopyFile2：：SetRemoteName 方法或 IBackgroundCopyJob3：：ReplaceRemotePrefix 方法。
示例
请参阅 IBackgroundCopyFile：：GetLocalName 方法的示例代码。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP |
| 最低受支持的服务器 | Windows Server 2003 |
| 目标平台 | Windows |
| 标头 | bits.h |
| Library | Bits.lib |
| DLL | QmgrPrxy.dll |