ftpSetCurrentDirectoryW 函式 (wininet.h)

FTP 伺服器上的不同工作目錄變更。

語法

BOOL FtpSetCurrentDirectoryW(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   lpszDirectory
);

[in] hConnect

FTP 會話的句柄。

[in] lpszDirectory

Null 終止字串的指標，其中包含要成為目前工作目錄之目錄的名稱。這可以是完整路徑或相對於目前目錄的名稱。

如果成功，則傳回 TRUE ，否則傳回 FALSE 。若要取得特定的錯誤訊息，請呼叫 GetLastError。如果錯誤訊息指出 FTP 伺服器拒絕變更目錄的要求，請使用 InternetGetLastResponseInfo 來判斷原因。

應用程式應該使用 FtpGetCurrentDirectory 來判斷遠端月臺的目前工作目錄，而不是假設遠端系統使用目錄的階層式命名配置。

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

就像 WinINet API 所有其他層面一樣，您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

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

注意

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

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wininet.h
程式庫	Wininet.lib
Dll	Wininet.dll