共用方式為


FtpRenameFileA 函式 (wininet.h)

重新命名儲存在 FTP 伺服器上的檔案。

語法

BOOL FtpRenameFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszExisting,
  [in] LPCSTR    lpszNew
);

參數

[in] hConnect

FTP 會話的句柄。

[in] lpszExisting

Null 終止字串的指標,其中包含要重新命名之檔名。

[in] lpszNew

包含遠端檔案新名稱之 Null 終止字串的指標。

傳回值

如果成功,則傳回 true true,否則會 傳回 false。 若要取得特定錯誤訊息,請呼叫 GetLastError

言論

lpszExistinglpszNew 參數可以是相對於目前目錄的部分或完整檔名。

如同 WinINet API 的其他所有層面,無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。 此外,不應該從服務使用。 針對伺服器實作或服務,請使用 Microsoft Windows HTTP 服務 (WinHTTP)
 

注意

wininet.h 標頭會根據 UNICODE 預處理器常數的定義,將 FtpRenameFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wininet.h
連結庫 Wininet.lib
DLL Wininet.dll

另請參閱

FTP 會話

WinINet 函式