通过

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-terminated 字符串的指针，该字符串包含主机的名称或点小数 IP 地址（如 198.105.232.1）。

[in] nServerPort

lpszHost Gopher 服务器的端口号，按主机字节顺序运行。 如果 nServerPortINTERNET_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。 若要获取扩展的错误信息，请调用 GetLastError 或 InternetGetLastResponseInfo。

言论

若要从 Gopher 服务器检索信息，应用程序必须首先从 Gopher 服务器获取 Gopher“定位符”。

应用程序应将其视为不透明令牌的定位符通常用于调用 GopherFindFirstFile 函数以检索特定信息片段。

与 WinINet API 的其他所有方面一样，不能从 DllMain 或全局对象的构造函数和析构函数中安全地调用此函数。

注意 WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP 服务（WinHTTP）。
 

注意

wininet.h 标头将 GopherCreateLocator 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows 2000 Professional [仅限桌面应用]
支持的最低服务器 Windows 2000 Server [仅限桌面应用]
目标平台 窗户
标头 wininet.h
库 Wininet.lib
DLL Wininet.dll

另请参阅

WinINet 函数