FtpGetCurrentDirectoryA 函式 (wininet.h)
擷取指定 FTP 工作階段的目前目錄。
語法
BOOL FtpGetCurrentDirectoryA(
[in] HINTERNET hConnect,
[out] LPSTR lpszCurrentDirectory,
[in, out] LPDWORD lpdwCurrentDirectory
);
參數
[in] hConnect
FTP 會話的句柄。
[out] lpszCurrentDirectory
接收目前目錄絕對路徑之 Null 終止字串的指標。
[in, out] lpdwCurrentDirectory
指定緩衝區長度之變數的指標,TCHAR中。 緩衝區長度必須包含終止 Null 字元的空間。 使用長度 MAX_PATH 就足以用於所有路徑。 當函式傳回時,變數會收到複製到緩衝區的字元數。
傳回值
如果成功,則傳回 true true,否則會 傳回 false。 若要取得特定錯誤訊息,請呼叫 GetLastError。
言論
如果 lpszCurrentDirectory 緩衝區不夠大,lpdwCurrentDirectory 會收到擷取完整目前目錄名稱所需的位元節數目。
如同 WinINet API 的其他所有層面,無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意 WinINet 不支援伺服器實作。 此外,不應該從服務使用。 針對伺服器實作或服務,請使用 Microsoft Windows HTTP 服務 (WinHTTP)。
注意
wininet.h 標頭會根據 UNICODE 預處理器常數的定義,將 FtpGetCurrentDirectory 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平臺 | 窗戶 |
標頭 | wininet.h |
連結庫 | Wininet.lib |
DLL | Wininet.dll |