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

Статья
11/20/2024

Извлекает последнее описание ошибки или ответ сервера в потоке, вызывающего эту функцию.

Синтаксис

BOOL InternetGetLastResponseInfoA(
  [out]     LPDWORD lpdwError,
  [out]     LPSTR   lpszBuffer,
  [in, out] LPDWORD lpdwBufferLength
);

Параметры

[out] lpdwError

Указатель на переменную, которая получает сообщение об ошибке, относящееся к операции, которая завершилась сбоем.

[out] lpszBuffer

Указатель на буфер, получающий текст ошибки.

[in, out] lpdwBufferLength

Указатель на переменную, содержащую размер буфера lpszBuffer, в TCHARs. Когда функция возвращается, этот параметр содержит размер строки, записанной в буфер, не включая нулю конца.

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

Возвращает TRUE, если текст ошибки был успешно записан в буфер или FALSE в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError. Если буфер слишком мал для хранения всего текста ошибки, GetLastError возвращает ERROR_INSUFFICIENT_BUFFER, а параметр lpdwBufferLength содержит минимальный размер буфера, необходимый для возврата всего текста ошибки.

Замечания

Протоколы FTP могут возвращать дополнительные текстовые сведения вместе с большинством ошибок. Эти расширенные сведения об ошибке можно получить с помощью функции InternetGetLastResponse Info, когда GetLastError возвращает ERROR_INTERNET_EXTENDED_ERROR (возникает после неудачного вызова функции).

Буфер, на который указывает lpszBuffer, должен быть достаточно большим, чтобы сохранить строку ошибки и нулевой терминатор в конце строки. Однако обратите внимание, что значение, возвращаемое в lpdwBufferLength, не включает нулю конца.

InternetGetLastResponseInfo можно вызывать несколько раз до вызова другой функции в этом потоке. При вызове другой функции внутренний буфер, в котором хранятся последние сведения об ответе, очищается.

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

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

Заметка

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

Требования

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

См. также

common Functions

функций WinINet

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