共用方式為

GopherOpenFileA 函式 (wininet.h)

  • 發行項

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

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

語法

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

參數

[in] hConnect

InternetConnect所傳回 Gopher 會話的控制碼。

[in] lpszLocator

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

[in] lpszView

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

[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 Services (WinHTTP) 。
 

注意

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

規格需求

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

另請參閱

WinINet 函式