通过

GopherOpenFileA 函数 （wininet.h）

  • 项目

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

开始从 Gopher 服务器读取 Gopher 数据文件。

语法

HINTERNET GopherOpenFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocator,
  [in] LPCSTR    lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

参数

[in] hConnect

InternetConnect返回的 Gopher 会话句柄。

[in] lpszLocator

指向 null-terminated 字符串的指针，该字符串指定要打开的文件。 通常，此定位符是从 调用 gopherFindFirstFile 或 InternetFindNextFile调用返回的。 由于 Gopher 协议没有当前目录的概念，因此定位符始终完全限定。

[in] lpszView

指向 null终止字符串的指针，该字符串描述在服务器上存在文件的多个视图时要打开的视图。 如果 lpszViewNULL，则该函数使用默认文件视图。

[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。

言论

GopherOpenFile 在 Gopher 服务器上打开文件。 由于文件实际上无法在服务器上打开或锁定，因此此函数只会将位置信息与应用程序可用于基于文件的操作（如 InternetReadFile 或 GopherGetAttribute）的句柄相关联。

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

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

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

注意

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

要求

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

另请参阅

WinINet 函数