通过

GopherGetAttributeW 函数 （wininet.h）

  • 项目

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

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

语法

BOOL GopherGetAttributeW(
  [in]  HINTERNET                   hConnect,
  [in]  LPCWSTR                     lpszLocator,
  [in]  LPCWSTR                     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

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

[out] lpBuffer

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

[in] dwBufferLength

TCHA中 lpBuffer 缓冲区的大小。

[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 服务（WinHTTP）。
 

注意

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

要求

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

另请参阅

WinINet 函数