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 结尾的字符串的指针，该字符串指定要打开的文件。 通常，此定位符是从对 GopherFindFirstFile 或 InternetFindNextFile 的调用返回的。 由于 Gopher 协议没有当前目录的概念，因此定位符始终是完全限定的。

[in] lpszView

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

[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 Services (WinHTTP) 。
 

注意

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

要求

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

另请参阅

WinINet 函数