GopherGetAttributeA 函数 (wininet.h)

  • 项目

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

从服务器检索特定属性信息。

语法

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [in]  DWORD_PTR                   dwContext
);

参数

[in] hConnect

InternetConnect 返回的 Gopher 会话的句柄。

[in] lpszLocator

指向以 null 结尾的字符串的指针，该字符串标识要返回属性信息的 Gopher 服务器上的项。

[in] lpszAttributeName

指向以空格分隔的字符串的指针，该字符串指定要返回的属性的名称。 如果 lpszAttributeName 为 NULL， 则 GopherGetAttribute 返回有关所有属性的信息。

[out] lpBuffer

指向从中检索属性信息的应用程序定义缓冲区的指针。

[in] dwBufferLength

lpBuffer 缓冲区的大小（以 TCHAR 为单位）。

[out] lpdwCharactersReturned

指向变量的指针，该变量包含读入 lpBuffer 缓冲区的字符数。

[in] lpfnEnumerator

指向枚举定位符的每个属性的 GopherAttributeEnumerator 回调函数的指针。 此参数是可选的。 如果为 NULL，则所有 Gopher 属性信息将放入 lpBuffer 中。 如果指定 了 lpfnEnumerator ，则为对象的每个属性调用回调函数一次。

回调函数通过每次调用接收单个 GOPHER_ATTRIBUTE_TYPE 结构的地址。 枚举回调函数允许应用程序避免分析 Gopher 属性信息。

[in] dwContext

将此操作与任何应用程序数据关联的应用程序定义值。

返回值

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

注解

通常，应用程序在调用 GopherFindFirstFile 或 InternetFindNextFile 后调用此函数。

lpBuffer 参数的大小必须等于或大于 MIN_GOPHER_ATTRIBUTE_LENGTH 的值。

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

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

注意

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

要求

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

另请参阅

WinINet 函数