通过

GopherFindFirstFileA 函数 （wininet.h）

  • 项目

[GopherFindFirstFile 函数可用于“要求”部分中指定的操作系统。

使用 Gopher 定位符和搜索条件创建与服务器的会话，并找到请求的文档、二进制文件、索引服务器或目录树。

语法

HINTERNET GopherFindFirstFileA(
  [in]  HINTERNET           hConnect,
  [in]  LPCSTR              lpszLocator,
  [in]  LPCSTR              lpszSearchString,
  [out] LPGOPHER_FIND_DATAA lpFindData,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

参数

[in] hConnect

InternetConnect返回的 Gopher 会话句柄。

[in] lpszLocator

指向 null-terminated 字符串的指针，其中包含要查找的项的名称。 这可以是下列项之一：

  • 上一次调用此函数或 InternetFindNextFile 函数返回的 Gopher 定位符。
  • NULL 指针或空字符串，指示返回 Gopher 服务器中最顶层的信息。
  • GopherCreateLocator 函数创建的定位符。

[in] lpszSearchString

如果此请求是索引服务器，则指向包含要搜索的字符串的缓冲区的指针。 否则，此参数应 NULL。

[out] lpFindData

指向接收此函数检索的信息 GOPHER_FIND_DATA 结构的指针。

[in] dwFlags

控制函数行为。 此参数可以是以下值的组合。

价值 意义
INTERNET_FLAG_HYPERLINK
 如果不存在 Expires 时间和从服务器返回的 LastModified 时间，则强制重新加载，确定是否从网络重新加载项。
INTERNET_FLAG_NEED_FILE
 如果无法缓存文件，将导致创建临时文件。
INTERNET_FLAG_NO_CACHE_WRITE
 不向缓存添加返回的实体。
INTERNET_FLAG_RELOAD
 强制从源服务器下载请求的文件、对象或目录列表，而不是从缓存下载。
INTERNET_FLAG_RESYNCHRONIZE
 如果自上次下载资源以来已修改资源，则重新加载 HTTP 资源。 将重新加载所有 FTP 和 Gopher 资源。

[in] dwContext

指向包含应用程序定义的值的变量的指针，该变量将此搜索与任何应用程序数据相关联。

返回值

如果成功，则返回有效的搜索句柄，否则 NULL。 若要检索扩展的错误信息，请调用 GetLastError 或 InternetGetLastResponseInfo。

言论

GopherFindFirstFile 与 findFirstFile 函数 非常相似。 它创建与 Gopher 服务器的连接，然后返回一个结构，其中包含有关定位符字符串引用的第一个 Gopher 对象的信息。

调用 GopherFindFirstFile 以检索枚举中的第一个 Gopher 对象后，应用程序可以使用 InternetFindNextFile 函数来检索后续 Gopher 对象。

调用应用程序使用 GopherFindFirstFile返回的 HINTERNET 句柄后，必须使用 InternetCloseHandle 函数将其关闭。

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

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

注意

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

要求

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

另请参阅

WinINet 函数