Fungsi InternetGetLastResponseInfoA (wininet.h)

  • Artikel

Mengambil deskripsi kesalahan terakhir atau respons server pada utas yang memanggil fungsi ini.

Sintaks

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

Parameter

[out] lpdwError

Penunjuk ke variabel yang menerima pesan kesalahan yang berkaitan dengan operasi yang gagal.

[out] lpszBuffer

Penunjuk ke buffer yang menerima teks kesalahan.

[in, out] lpdwBufferLength

Penunjuk ke variabel yang berisi ukuran buffer lpszBuffer , dalam TCHAR. Ketika fungsi kembali, parameter ini berisi ukuran string yang ditulis ke buffer, tidak termasuk nol yang mengakhiri.

Nilai kembali

Mengembalikan TRUE jika teks kesalahan berhasil ditulis ke buffer, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Jika buffer terlalu kecil untuk menahan semua teks kesalahan, GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, dan parameter lpdwBufferLength berisi ukuran buffer minimum yang diperlukan untuk mengembalikan semua teks kesalahan.

Keterangan

Protokol FTP dapat mengembalikan informasi teks tambahan bersama dengan sebagian besar kesalahan. Informasi kesalahan yang diperluas ini dapat diambil dengan menggunakan fungsi InternetGetLastResponseInfo setiap kali GetLastError mengembalikan ERROR_INTERNET_EXTENDED_ERROR (terjadi setelah panggilan fungsi yang gagal).

Buffer yang ditunjukkan oleh lpszBuffer harus cukup besar untuk menahan string kesalahan dan terminator nol di akhir string. Namun, perhatikan bahwa nilai yang dikembalikan dalam lpdwBufferLength tidak menyertakan nol penghentian.

InternetGetLastResponseInfo dapat dipanggil beberapa kali sampai fungsi lain dipanggil pada utas ini. Ketika fungsi lain dipanggil, buffer internal yang menyimpan informasi respons terakhir dihapus.

Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).
 

Catatan

Header wininet.h mendefinisikan InternetGetLastResponseInfo sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header wininet.h
Pustaka Wininet.lib
DLL Wininet.dll

Lihat juga

Fungsi Umum

Fungsi WinINet