共用方式為


GopherCreateLocatorW 函式 (wininet.h)

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

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

語法

BOOL GopherCreateLocatorW(
  [in]      LPCWSTR       lpszHost,
  [in]      INTERNET_PORT nServerPort,
  [in]      LPCWSTR       lpszDisplayString,
  [in]      LPCWSTR       lpszSelectorString,
  [in]      DWORD         dwGopherType,
  [out]     LPWSTR        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

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

[in, out] lpdwBufferLength

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

傳回值

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

備註

若要從 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 函式