Fungsi InternetGetCookieExA (wininet.h)
Fungsi InternetGetCookieEx mengambil data yang disimpan dalam cookie yang terkait dengan URL tertentu. Tidak seperti InternetGetCookie, InternetGetCookieEx dapat digunakan untuk membatasi data yang diambil ke satu nama cookie atau, berdasarkan kebijakan, yang terkait dengan situs yang tidak tepercaya atau cookie pihak ketiga.
BOOL InternetGetCookieExA(
[in] LPCSTR lpszUrl,
[in] LPCSTR lpszCookieName,
[in, out, optional] LPSTR lpszCookieData,
[in, out] LPDWORD lpdwSize,
[in] DWORD dwFlags,
[in] LPVOID lpReserved
);
[in] lpszUrl
Penunjuk ke untai (karakter) null-dihentikan yang berisi URL tempat cookie yang akan diambil dikaitkan. Parameter ini tidak dapat NULL atau InternetGetCookieEx gagal dan mengembalikan kesalahan ERROR_INVALID_PARAMETER.
[in] lpszCookieName
Penunjuk ke untai (karakter) nullyang dihentikan yang berisi nama cookie yang akan diambil. Nama ini peka huruf besar/kecil.
[in, out, optional] lpszCookieData
Penunjuk ke buffer untuk menerima data cookie.
[in, out] lpdwSize
Penunjuk ke variabel DWORD.
Pada entri, variabel harus berisi ukuran, dalam TCHAR, dari buffer yang ditujukkan oleh parameter pchCookieData
Saat keluar, jika fungsi berhasil, variabel ini berisi jumlah TCHAR data cookie yang disalin ke dalam buffer. Jika
Parameter ini tidak dapat NULL atau InternetGetCookieEx gagal dan mengembalikan kesalahan ERROR_INVALID_PARAMETER.
[in] dwFlags
Bendera yang mengontrol cara fungsi mengambil data cookie. Parameter ini bisa menjadi salah satu nilai berikut.
[in] lpReserved
Dicadangkan untuk digunakan di masa mendatang. Atur ke NULL.
Jika fungsi berhasil, fungsi mengembalikan TRUE.
Jika fungsi gagal, fungsi mengembalikan FALSE. Untuk mendapatkan nilai kesalahan tertentu, panggil GetLastError.
Jika NULL diteruskan ke lpszCookieData, panggilan akan berhasil dan fungsi tidak akan diatur ERROR_INSUFFICIENT_BUFFER.
Kode kesalahan berikut dapat diatur oleh fungsi ini.
Mengembalikan kode | Deskripsi |
---|---|
|
Dikembalikan jika data cookie yang diambil lebih besar dari ukuran buffer yang ditunjukkan oleh parameter |
|
Dikembalikan jika |
|
Dikembalikan jika tidak ada data cookie seperti yang ditentukan yang dapat diambil. |
Catatan
Header wininet.h mendefinisikan InternetGetCookieEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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.
Syarat | Nilai |
---|---|
klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Platform Target |
Windows |
Header |
wininet.h |
Pustaka |
Wininet.lib |
DLL |
Wininet.dll |
Cookie HTTP
Fungsi WinINet