GopherCreateLocatorA 函式 (wininet.h)

  • 發行項

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

從選取器字串的元件元件元件建立 Gopher 或 Gopher+ 定位器字串。

語法

BOOL GopherCreateLocatorA(
  [in]      LPCSTR        lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCSTR        lpszDisplayString,
  [in]      LPCSTR        lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPSTR         lpszLocator,
  [in, out] LPDWORD       lpdwBufferLength
);

參數

[in] lpszHost

包含主機名稱稱的 Null終止字串指標，或小數點 IP 位址 (，例如 198.105.232.1) 。

[in] nServerPort

Gopher 伺服器在 lpszHost 所在的埠號碼，以主機位元組順序存留。 如果 nServerPort是INTERNET_INVALID_PORT_NUMBER，則會使用預設 Gopher 埠。

[in] lpszDisplayString

Null終止字串的指標，其中包含要顯示的 Gopher 檔或目錄。 如果此參數為 Null，函式會傳回 Gopher 伺服器的預設目錄。

[in] lpszSelectorString

要傳送至 Gopher 伺服器的選取器字串指標，以擷取資訊。 此參數可以是 Null。

[in] dwGopherType

判斷 lpszSelectorString 是否參考目錄或檔，以及要求是否為 Gopher+ 或 Gopher。 如果 dwGopherType 的值為零，則會使用預設值 GOPHER_TYPE_DIRECTORY。 這可以是其中一個 Gopher 類型值。

[out] lpszLocator

接收定位器字串之緩衝區的指標。 如果 lpszLocator 為 Null， lpdwBufferLength 會收到必要的緩衝區長度，但函式不會執行任何其他處理。

[in, out] lpdwBufferLength

變數的指標，其中包含 字元中 lpszLocator 緩衝區的長度。 當函式傳回時，此參數會接收寫入緩衝區的字元數。 如果 GetLastError 傳回 ERROR_INSUFFICIENT_BUFFER，此參數會收到所需的字元數。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 或 InternetGetLastResponseInfo。

備註

若要從 Gopher 伺服器擷取資訊，應用程式必須先從 Gopher 伺服器取得 Gopher「定位器」。

應用程式應該視為不透明權杖的定位器通常會用於呼叫 GopherFindFirstFile 函式以擷取特定資訊片段。

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

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

注意

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

規格需求

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

另請參閱

WinINet 函式