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
控制函式行為。 此參數可以是下列值的組合。
| 價值 | 意義 |
|---|---|
|
判斷是否要從網路重載專案時，如果沒有任何 Expires 時間和從伺服器傳回的 LastModified 時間，則強制重載。 |
|
如果無法快取檔案，就會建立暫存盤。 |
|
不會將傳回的實體新增至快取。 |
|
強制從源伺服器下載要求的檔案、對象或目錄清單，而不是從快取下載。 |
|
如果資源自上次下載後已修改，就會重載 HTTP 資源。 所有 FTP 和 Gopher 資源都會重載。 |
[in] dwContext
變數的指標，其中包含與任何應用程式數據建立關聯之應用程式定義的值。
傳回值
如果成功，則傳回有效的搜尋句柄，否則 NULL。 若要擷取擴充的錯誤資訊，請呼叫 getLastError 或 InternetGetLastResponseInfo。
言論
呼叫 GopherFindFirstFile 擷取列舉中的第一個 Gopher 物件之後，應用程式可以使用 InternetFindNextFile 函式來擷取後續的 Gopher 物件。
呼叫應用程式使用 GopherFindFirstFile傳回的 HINTERNET 句柄之後，必須使用 InternetCloseHandle 函式關閉。
如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意
wininet.h 標頭會根據 UNICODE 預處理器常數的定義，將 GopherFindFirstFile 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | wininet.h |
| 連結庫 | Wininet.lib |
| DLL | Wininet.dll |