Funzione WinHttpGetDefaultProxyConfiguration (winhttp.h)

La funzione WinHttpGetDefaultProxyConfiguration recupera la configurazione del proxy WinHTTP predefinita dal Registro di sistema.

Sintassi

WINHTTPAPI BOOL WinHttpGetDefaultProxyConfiguration(
  [in, out] WINHTTP_PROXY_INFO *pProxyInfo
);

Parametri

[in, out] pProxyInfo

Puntatore a una variabile di tipo WINHTTP_PROXY_INFO che riceve la configurazione del proxy predefinita.

Valore restituito

Restituisce TRUE se ha esito positivo o FALSE in caso contrario. Per recuperare un messaggio di errore specifico, chiamare GetLastError. I codici di errore restituiti includono quanto segue.

Commenti

WinHttpGetDefaultProxyConfiguration recupera la configurazione del proxy impostata da WinHttpSetDefaultProxyConfiguration o ProxyCfg.exe.

La configurazione proxy predefinita può essere sostituita per una sessione WinHTTP chiamando WinHttpSetOption e specificando il flag WINHTTP_OPTION_PROXY .
WinHttpGetDefaultProxyConfiguration non recupera la configurazione per la sessione corrente. Recupera la configurazione specificata nel Registro di sistema.

Se il Registro di sistema contiene un elenco di server proxy, il membro dwAccessType di pProxyInfo è impostato su WINHTTP_ACCESS_TYPE_NAMED_PROXY. In caso contrario, è impostato su WINHTTP_ACCESS_TYPE_NO_PROXY.

WinHttpGetDefaultProxyConfiguration alloca memoria per i membri stringa di pProxyInfo. Per liberare questa memoria, chiama GlobalFree.

Anche quando WinHTTP viene usato in modalità asincrona , ovvero quando WINHTTP_FLAG_ASYNC è stato impostato in WinHttpOpen, questa funzione funziona in modo sincrono. Il valore restituito indica l'esito positivo o negativo. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Esempio

Nell'esempio di codice seguente viene illustrato come recuperare la configurazione del proxy predefinita dal Registro di sistema.

    WINHTTP_PROXY_INFO proxyInfo;

    // Retrieve the default proxy configuration.
    WinHttpGetDefaultProxyConfiguration( &proxyInfo );

    // Display the proxy servers and free memory 
    // allocated to this string.
    if (proxyInfo.lpszProxy != NULL)
    {
        printf("Proxy server list: %S\n", proxyInfo.lpszProxy);
        GlobalFree( proxyInfo.lpszProxy );
    }

    // Display the bypass list and free memory 
    // allocated to this string.
    if (proxyInfo.lpszProxyBypass != NULL)
    {
        printf("Proxy bypass list: %S\n", proxyInfo.lpszProxyBypass);
        GlobalFree( proxyInfo.lpszProxyBypass );
    }

Requisiti

Vedi anche

ProxyCfg.exe, uno strumento di configurazione proxy

Versioni di WinHTTP

WinHttpSetDefaultProxyConfiguration