共用方式為

GopherOpenFileW 函式 （wininet.h）

  • 發行項

[GopherOpenFile 函式可用於需求一節中指定的作業系統。

開始從 Gopher 伺服器讀取 Gopher 資料檔。

語法

HINTERNET GopherOpenFileW(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   lpszLocator,
  [in] LPCWSTR   lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

參數

[in] hConnect

InternetConnect所傳回的 Gopher 會話句柄。

[in] lpszLocator

null終止字串的指標，指定要開啟的檔案。 一般而言，此定位器會從呼叫 GopherFindFirstFile 或 InternetFindNextFile傳回。 由於 Gopher 通訊協定沒有目前目錄的概念，因此定位器一律會完整。

[in] lpszView

如果伺服器上存在檔案的數個檢視，則 null的指標終止字串，描述要開啟的檢視。 如果 lpszViewNULL，則函式會使用預設檔案檢視。

[in] dwFlags

後續傳輸發生的情況。 此參數可以是下列任何值。

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

[in] dwContext

變數的指標，其中包含與任何應用程式數據建立關聯之應用程式定義的值。

傳回值

如果成功，則傳回句柄，如果無法開啟檔案，則傳回 null。 若要擷取擴充的錯誤資訊，請呼叫 getLastError 或 InternetGetLastResponseInfo。

言論

GopherOpenFile 會在 Gopher 伺服器上開啟檔案。 因為檔案實際上無法在伺服器上開啟或鎖定，所以此函式只會將位置資訊與應用程式可用於檔案型作業的句柄產生關聯，例如 InternetReadFile 或 GopherGetAttribute。

呼叫應用程式使用 GopherOpenFile所傳回 HINTERNET 句柄之後，必須使用 internetCloseHandle 函式 關閉。

如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

注意 WinINet 不支援伺服器實作。 此外，不應該從服務使用。 針對伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 （WinHTTP）。
 

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 wininet.h
連結庫 Wininet.lib
DLL Wininet.dll

另請參閱

WinINet 函式