Funzione WinHttpDetectAutoProxyConfigUrl (winhttp.h)

Articolo
08/27/2023

La funzione WinHttpDetectAutoProxyConfigUrl trova l'URL del file pac (Proxy Auto Configuration). Questa funzione segnala l'URL del file PAC, ma non scarica il file.

Sintassi

WINHTTPAPI BOOL WinHttpDetectAutoProxyConfigUrl(
  [in]  DWORD  dwAutoDetectFlags,
  [out] LPWSTR *ppwstrAutoConfigUrl
);

Parametri

[in] dwAutoDetectFlags

Tipo di dati che specifica i protocolli da usare per individuare il file PAC. Se vengono impostati entrambi i flag di rilevamento automatico DHCP e DNS, viene usato per primo DHCP; se non viene individuato alcun URL PAC tramite DHCP, viene usato DNS.

Valore	Significato
WINHTTP_AUTO_DETECT_TYPE_DHCP	Usare DHCP per individuare il file di configurazione automatica del proxy.
WINHTTP_AUTO_DETECT_TYPE_DNS_A	Usare DNS per tentare di individuare il file di configurazione automatica del proxy in un percorso noto nel dominio del computer locale.

[out] ppwstrAutoConfigUrl

Tipo di dati che restituisce un puntatore a una stringa Unicode con terminazione Null contenente l'URL di configurazione che riceve i dati proxy. È necessario liberare la stringa a cui punta ppwszAutoConfigUrl usando la funzione GlobalFree .

Valore restituito

Restituisce TRUE se l'operazione riesce o FALSE in caso contrario. Per informazioni sugli errori estesi, chiamare GetLastError. Tra i codici di errore restituiti sono riportati di seguito.

Codice di errore	Descrizione
ERROR_WINHTTP_AUTODETECTION_FAILED	Restituito se WinHTTP non è riuscito a individuare l'URL del file di configurazione automatica del proxy.
ERROR_WINHTTP_INTERNAL_ERROR	Si è verificato un errore interno.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare l'operazione richiesta. (Codice errore di Windows)

Commenti

WinHTTP implementa il protocollo WPAD (Web Proxy Auto-Discovery), spesso definito autoproxy. Per altre informazioni sulle posizioni note, vedere la sezione Processo di individuazione del documento del protocollo WPAD.

Si noti che poiché la funzione WinHttpDetectAutoProxyConfigUrl richiede tempo per completare l'operazione, non deve essere chiamata da un thread dell'interfaccia utente.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winhttp.h
Libreria	Winhttp.lib
DLL	Winhttp.dll

Vedi anche

Versioni di WinHTTP

Condividi tramite