Fungsi InternetGetProxyInfo

Artikel
06/13/2023

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.dllsecara 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	JSProxy.dll