FtpCommandW 函式 (wininet.h)
FtpCommand 函式會將命令直接傳送至 FTP 伺服器。
語法
BOOL FtpCommandW(
[in] HINTERNET hConnect,
[in] BOOL fExpectResponse,
[in] DWORD dwFlags,
[in] LPCWSTR lpszCommand,
[in] DWORD_PTR dwContext,
[out] HINTERNET *phFtpCommand
);
參數
[in] hConnect
從 呼叫 InternetConnect 傳回的句柄。
[in] fExpectResponse
布爾值,指出應用程式是否預期 FTP 伺服器建立數據連線。 如果預期數據連線,則此設定為 TRUE ,否則為 FALSE 。
[in] dwFlags
參數,可設定為下列其中一個值。
值 | 意義 |
---|---|
|
使用 FTP ASCII (Type 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 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應