Condividi tramite

Funzione InternetGetProxyInfo

  • Articolo

Importante

Questa funzione è deprecata in Windows 10 e non è supportata a partire da Windows 11. Per il supporto di autoproxy, usare invece SERVIZI HTTP (WinHTTP) versione 5.1. Per altre informazioni, vedere Supporto di WinHTTP AutoProxy.

Recupera i dati proxy per l'accesso alle risorse specificate. Questa funzione può essere chiamata solo caricando in modo esplicito JSProxy.dll.

Sintassi

BOOL InternetGetProxyInfo(
  _In_  LPCSTR  lpszUrl,
  _In_  DWORD   dwUrlLength,
  _In_  LPSTR   lpszUrlHostName,
  _In_  DWORD   dwUrlHostNameLength,
  _Out_ LPSTR   *lplpszProxyHostName,
  _Out_ LPDWORD lpdwProxyHostNameLength
);

Parametri

lpszUrl [in]

Puntatore a una stringa con terminazione null che specifica l'URL della risorsa HTTP di destinazione.

dwUrlLength [in]

Dimensioni, in byte, dell'URL a cui punta lpszUrl.

lpszUrlHostName [in]

Puntatore a una stringa con terminazione null che specifica il nome host dell'URL di destinazione.

dwUrlHostNameLength [in]

Dimensioni, in byte, del nome host a cui fa riferimento lpszUrlHostName.

lplpszProxyHostName [out]

Puntatore all'indirizzo di un buffer che riceve l'URL del proxy da usare in una richiesta HTTP per la risorsa specificata. L'applicazione è responsabile della liberazione di questa stringa.

lpdwProxyHostNameLength [out]

Puntatore a una variabile che riceve le dimensioni, in byte, della stringa restituita nel buffer lplpszProxyHostName .

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per ottenere dati di errore estesi, chiamare GetLastError.

Commenti

Per chiamare InternetGetProxyInfo, è necessario collegarlo dinamicamente usando il tipo di puntatore a funzione definito pfnInternetGetProxyInfo. Il frammento di codice seguente illustra come dichiarare un'istanza di questo tipo di puntatore a funzione e quindi inizializzarla e chiamarla.

  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.

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro dall'interno di DllMain o dai costruttori e distruttori di oggetti globali.

Nota

WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni o i servizi server usano Microsoft Windows HTTP Services (WinHTTP).

Requisiti

Requisito Valore
Client minimo supportato
 Windows 2000 Professional [solo app desktop]
Non supportato a partire da Windows 11
Server minimo supportato
 Windows 2000 Server [solo app desktop]
DLL
JSProxy.dll

Vedi anche