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 结尾的字符串的指针，或者指向 (（如 198.105.232.1) ）的点数十进制 IP 地址的指针。

[in] nServerPort

Gopher 服务器位于 lpszHost 的所在端口号，按主机字节顺序排列。 如果 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

指向接收定位符字符串的缓冲区的指针。 如果 lpszLocator 为 NULL， 则 lpdwBufferLength 接收必要的缓冲区长度，但函数不会执行其他处理。

[in, out] lpdwBufferLength

指向包含 lpszLocator 缓冲区长度（以字符为单位）的变量的指针。 函数返回时，此参数接收写入缓冲区的字符数。 如果 GetLastError 返回 ERROR_INSUFFICIENT_BUFFER，则此参数接收所需的字符数。

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。 若要获取扩展错误信息，请调用 GetLastError 或 InternetGetLastResponseInfo。

注解

若要从 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
Library Wininet.lib
DLL Wininet.dll

另请参阅

WinINet 函数