Fungsi InternetGetProxyInfo
Penting
Fungsi ini tidak digunakan lagi pada Windows 10, dan tidak didukung pada Windows 11. Untuk dukungan autoproxy, gunakan Http Services (WinHTTP) versi 5.1 sebagai gantinya. Untuk informasi selengkapnya, lihat Dukungan WinHTTP AutoProxy.
Mengambil data proksi untuk mengakses sumber daya tertentu. Fungsi ini hanya dapat dipanggil dengan memuat JSProxy.dll
secara eksplisit .
Sintaks
BOOL InternetGetProxyInfo(
_In_ LPCSTR lpszUrl,
_In_ DWORD dwUrlLength,
_In_ LPSTR lpszUrlHostName,
_In_ DWORD dwUrlHostNameLength,
_Out_ LPSTR *lplpszProxyHostName,
_Out_ LPDWORD lpdwProxyHostNameLength
);
Parameter
-
lpszUrl [in]
-
Penunjuk ke string yang dihentikan null yang menentukan URL sumber daya HTTP target.
-
dwUrlLength [in]
-
Ukuran, dalam byte, dari URL yang ditunjukkan oleh lpszUrl.
-
lpszUrlHostName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama host URL target.
-
dwUrlHostNameLength [in]
-
Ukuran, dalam byte, dari nama host yang ditunjukkan oleh lpszUrlHostName.
-
lplpszProxyHostName [out]
-
Penunjuk ke alamat buffer yang menerima URL proksi untuk digunakan dalam permintaan HTTP untuk sumber daya yang ditentukan. Aplikasi bertanggung jawab untuk membebaskan string ini.
-
lpdwProxyHostNameLength [out]
-
Penunjuk ke variabel yang menerima ukuran, dalam byte, dari string yang dikembalikan dalam buffer lplpszProxyHostName .
Menampilkan nilai
Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya. Untuk mendapatkan data kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Untuk memanggil InternetGetProxyInfo, Anda harus secara dinamis menautkannya menggunakan pfnInternetGetProxyInfo jenis penunjuk fungsi yang ditentukan. Cuplikan kode di bawah ini menunjukkan cara mendeklarasikan instans jenis penunjuk fungsi ini lalu menginisialisasi dan memanggilnya.
HMODULE hModJS; // Handle for loading the DLL
pfnInternetGetProxyInfo pIGPI; // Function-pointer instance
hModJS = LoadLibrary( TEXT("jsproxy.dll") );
if (!hModJS)
{
_tprintf( TEXT("\nLoadLibrary failed to load jsproxy.dll with error: %d\n"),
GetLastError( ) );
return( FALSE );
}
pIGPI = (pfnInternetGetProxyInfo)
GetProcAddress( hModJS, "InternetGetProxyInfo" );
if (!pIGPI)
{
_tprintf( TEXT("\nGetProcAddress failed to find InternetGetProxyInfo, error: %d\n"),
GetLastError( ) );
return( FALSE );
}
// The pIGPI function pointer can now be used to call InternetGetProxyInfo.
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).
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] Tidak didukung pada Windows 11 |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
DLL |
|