共用方式為

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 的指標-terminated 字串，其中包含主機的名稱，或 dotted-decimal IP 位址（例如 198.105.232.1）。

[in] nServerPort

lpszHost Gopher 伺服器的埠號碼會以主機位元組順序存回。 如果 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

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

[in, out] lpdwBufferLength

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

傳回值

如果成功，則傳回 true true，否則會 傳回 false。 若要取得擴充的錯誤資訊，請呼叫 getLastError 或 InternetGetLastResponseInfo。

言論

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

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

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

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

注意

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

要求

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

另請參閱

WinINet 函式