ftpCommandA 函式 (wininet.h)
FtpCommand函式會將命令直接傳送至 FTP 伺服器。
語法
BOOL FtpCommandA(
[in] HINTERNET hConnect,
[in] BOOL fExpectResponse,
[in] DWORD dwFlags,
[in] LPCSTR lpszCommand,
[in] DWORD_PTR dwContext,
[out] HINTERNET *phFtpCommand
);
參數
[in] hConnect
從呼叫 InternetConnect傳回的控制碼。
[in] fExpectResponse
布林值,指出應用程式是否預期 FTP 伺服器建立資料連線。 如果預期有資料連線,則這必須設定為 TRUE ,否則為 FALSE 。
[in] dwFlags
參數,可設定為下列其中一個值。
值 | 意義 |
---|---|
|
使用 FTP ASCII (類型 A) 傳輸方法來傳輸檔案。 控制項和格式化資料會轉換成本機對等專案。 |
|
使用 FTP 映射 (類型 I) 傳輸方法傳輸檔案。 檔案會完全傳輸,且沒有任何變更。 這是預設傳輸方法。 |
[in] lpszCommand
字串的指標,其中包含要傳送至 FTP 伺服器的命令。
[in] dwContext
變數的指標,其中包含用來識別回呼作業中應用程式內容的應用程式定義值。
[out] phFtpCommand
如果開啟有效的資料通訊端,則為所建立控制碼的指標。 fExpectResponse參數必須設定為TRUE,才能填滿phFtpCommand。
傳回值
如果成功,則傳回 TRUE ,否則傳回 FALSE 。 若要取得特定的錯誤訊息,請呼叫 GetLastError。
備註
如果用戶端應用程式離線,GetLastError可以傳回ERROR_INTERNET_NO_DIRECT_ACCESS。 如果一或多個參數無效, GetLastError 會 傳回ERROR_INVALID_PARAMETER。
就像 WinINet API 所有其他層面一樣,您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意
wininet.h 標頭會將 FtpCommand 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應