IBackgroundCopyFile::GetRemoteName 方法 (bits.h)
擷取檔案的遠端名稱。
語法
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 |
程式庫 | Bits.lib |
Dll | QmgrPrxy.dll |