GopherFindFirstFileA 函式 (wininet.h)
[ GopherFindFirstFile 函式可用於需求一節中指定的作業系統。
使用 Gopher 定位器和搜尋準則來建立與伺服器的會話,並找出所要求的檔、二進位檔案、索引伺服器或目錄樹狀架構。
語法
HINTERNET GopherFindFirstFileA(
[in] HINTERNET hConnect,
[in] LPCSTR lpszLocator,
[in] LPCSTR lpszSearchString,
[out] LPGOPHER_FIND_DATAA lpFindData,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
參數
[in] hConnect
處理 InternetConnect所傳回的 Gopher 會話。
[in] lpszLocator
Null終止字串的指標,其中包含要尋找的專案名稱。 這可以是下列項目之一:
- 先前呼叫此函式或 InternetFindNextFile 函式所傳回的 Gopher 定位器。
- Null 指標或空字串,指出要從 Gopher 伺服器傳回最上層的資訊。
- GopherCreateLocator函式所建立的定位器。
[in] lpszSearchString
如果此要求是索引伺服器,則為包含要搜尋之字串的緩衝區指標。 否則,此參數應該是 Null。
[out] lpFindData
接收此函式所擷取之資訊的 GOPHER_FIND_DATA 結構的指標。
[in] dwFlags
控制函式行為。 此參數可以是下列值的組合。
值 | 意義 |
---|---|
|
在判斷是否要從網路重載專案時,強制重載沒有 「到期時間」,且沒有從伺服器傳回的 LastModified 時間。 |
|
如果無法快取檔案,就會建立暫存檔案。 |
|
不會將傳回的實體新增至快取。 |
|
強制從源伺服器下載要求的檔案、物件或目錄清單,而不是從快取下載。 |
|
如果資源自上次下載後已修改,則會重載 HTTP 資源。 所有 FTP 和 Gopher 資源都會重載。 |
[in] dwContext
變數的指標,其中包含應用程式定義的值,這個值會與此搜尋與任何應用程式資料產生關聯。
傳回值
如果成功,則傳回有效的搜尋控制碼,否則傳回 Null 。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError 或 InternetGetLastResponseInfo。
備註
GopherFindFirstFile 非常類似 FindFirstFile 函式。 它會建立與 Gopher 伺服器的連線,然後傳回單一結構,其中包含定位器字串所參考之第一個 Gopher 物件的相關資訊。
呼叫 GopherFindFirstFile 以擷取列舉中的第一個 Gopher 物件之後,應用程式可以使用 InternetFindNextFile 函式來擷取後續的 Gopher 物件。
呼叫應用程式使用GopherFindFirstFile傳回的HINTERNET控制碼完成之後,必須使用InternetCloseHandle函式來關閉它。
就像 WinINet API 的其他所有層面一樣,無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。
注意
wininet.h 標頭會根據 UNICODE 預處理器常數的定義,將 GopherFindFirstFile 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wininet.h |
程式庫 | Wininet.lib |
Dll | Wininet.dll |