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 |