Поделиться через

Функция 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

Обработка сеанса Gopher, возвращаемого InternetConnect.

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

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).
 

Примечание

Заголовок wininet.h определяет GopherGetAttribute как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header wininet.h
Библиотека Wininet.lib
DLL Wininet.dll

См. также раздел

Функции WinINet