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

控制函式行為。 此參數可以是下列值的組合。

意義
INTERNET_FLAG_HYPERLINK
在判斷是否要從網路重載專案時,強制重載沒有 「到期時間」,且沒有從伺服器傳回的 LastModified 時間。
INTERNET_FLAG_NEED_FILE
如果無法快取檔案,就會建立暫存檔案。
INTERNET_FLAG_NO_CACHE_WRITE
不會將傳回的實體新增至快取。
INTERNET_FLAG_RELOAD
強制從源伺服器下載要求的檔案、物件或目錄清單,而不是從快取下載。
INTERNET_FLAG_RESYNCHRONIZE
如果資源自上次下載後已修改,則會重載 HTTP 資源。 所有 FTP 和 Gopher 資源都會重載。

[in] dwContext

變數的指標,其中包含應用程式定義的值,這個值會與此搜尋與任何應用程式資料產生關聯。

傳回值

如果成功,則傳回有效的搜尋控制碼,否則傳回 Null 。 若要擷取擴充的錯誤資訊,請呼叫 GetLastErrorInternetGetLastResponseInfo

備註

GopherFindFirstFile 非常類似 FindFirstFile 函式。 它會建立與 Gopher 伺服器的連線,然後傳回單一結構,其中包含定位器字串所參考之第一個 Gopher 物件的相關資訊。

呼叫 GopherFindFirstFile 以擷取列舉中的第一個 Gopher 物件之後,應用程式可以使用 InternetFindNextFile 函式來擷取後續的 Gopher 物件。

呼叫應用程式使用GopherFindFirstFile傳回的HINTERNET控制碼完成之後,必須使用InternetCloseHandle函式來關閉它。

就像 WinINet API 的其他所有層面一樣,無法在 DllMain 或全域物件的建構函式和解構函式內安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。 此外,它不應該從服務使用。 對於伺服器實作或服務,請使用 Microsoft Windows HTTP 服務 (WinHTTP)
 

注意

wininet.h 標頭會根據 UNICODE 預處理器常數的定義,將 GopherFindFirstFile 定義為別名,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 wininet.h
程式庫 Wininet.lib
Dll Wininet.dll

另請參閱

WinINet 函式