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

另請參閱

IBackgroundCopyFile

IBackgroundCopyFile：：GetLocalName

IBackgroundCopyJob：：AddFile

IBackgroundCopyJob：：AddFileSet