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 函式