Функция GopherGetAttributeA (wininet.h)

Статья
11/20/2024

[Функция 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-terminated, которая идентифицирует элемент на сервере Gopher, на котором возвращаются сведения о атрибутах.

[in] lpszAttributeName

Указатель на строку с разделителями пространства, указывающую имена возвращаемых атрибутов. Если lpszAttributeNameNULL, GopherGetAttribute возвращает сведения обо всех атрибутах.

[out] lpBuffer

Указатель на определенный приложением буфер, из которого извлекаются сведения о атрибуте.

[in] dwBufferLength

Размер буфера lpBuffer в TCHARs.

[out] lpdwCharactersReturned

Указатель на переменную, содержащую число символов, считываемых в буфер lpBuffer.

[in] lpfnEnumerator

Указатель на функцию обратного вызова GopherAttributeEnumerator, которая перечисляет каждый атрибут указателя. Этот параметр является необязательным. Еслизначение NULL, все сведения о атрибуте Gopher помещаются в lpBuffer. Если указан lpfnEnumerator, функция обратного вызова вызывается один раз для каждого атрибута объекта.

Функция обратного вызова получает адрес одной GOPHER_ATTRIBUTE_TYPE структуры с каждым вызовом. Функция обратного вызова перечисления позволяет приложению избежать анализа сведений о атрибуте Gopher.

[in] dwContext

Определяемое приложением значение, которое связывает эту операцию с любыми данными приложения.

Возвращаемое значение

Возвращает TRUE, если запрос удовлетворен или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError или InternetGetLastLastResponseInfo.

Замечания

Как правило, приложения вызывают эту функцию после вызова GopherFindFirstFile или InternetFindNextFile.

Размер параметра lpBuffer должен быть равен или больше значения MIN_GOPHER_ATTRIBUTE_LENGTH.

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

функций WinINet

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