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
接收定位器字串之緩衝區的指標。 如果 lpszLocator 為 NULL，lpdwBufferLength 會收到必要的緩衝區長度，但函式不會執行任何其他處理。
[in, out] lpdwBufferLength
變數的指標，其中包含 字元中 lpszLocator 緩衝區的長度。 當函式傳回時，此參數會接收寫入緩衝區的字元數。 如果 GetLastError 傳回 ERROR_INSUFFICIENT_BUFFER，此參數會收到所需的字元數。
傳回值
如果成功，則傳回 TRUE ，否則傳回 FALSE 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError 或 InternetGetLastResponseInfo。
備註
若要從 Gopher 伺服器擷取資訊，應用程式必須先從 Gopher 伺服器取得 Gopher「定位器」。
應用程式應該視為不透明令牌的定位器通常會用於呼叫 GopherFindFirstFile 函式以擷取特定資訊片段。
就像 WinINet API 所有其他層面一樣，您無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。
注意
wininet.h 標頭會將 GopherCreateLocator 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | wininet.h |
| 程式庫 | Wininet.lib |
| Dll | Wininet.dll |