75 lines
2.6 KiB
Plaintext
75 lines
2.6 KiB
Plaintext
SUMMARY
|
||
=======
|
||
WinHttp application for determining the proxy for a particular URL.
|
||
This sample demonstrates the core functionality for querying the proxy settings.
|
||
Additional features may be added by the application/module basing their proxy code from this sample, including but not limited to:
|
||
1) Per URL proxy cache.
|
||
2) Network Change awareness.
|
||
3) Bad Proxy Filter.
|
||
|
||
Applications running as a service who have an interactive user to impersonate
|
||
should impersonate the user and then use this sample code to get proxy settings.
|
||
Applications without a user to impersonate should first use
|
||
WinHttpGetDefaultProxyConfiguration first and if no settings are configured try
|
||
AutoDetection using WinHttpGetProxyForUrl followed by no-proxy if both fail.
|
||
|
||
Security Note
|
||
=============
|
||
|
||
This sample is provided for educational purpose only to demonstrate how to use Windows
|
||
WinHTTP API. It is not intended to be used without modifications in a production
|
||
environment and it has not been tested in a production environment. Microsoft assumes
|
||
no liability for incidental or consequential damages should the sample code be used for
|
||
purposes other than as intended.
|
||
|
||
USAGE
|
||
=====
|
||
This sample includes Microsoft Visual Studio .NET project files. To create "Winhttp Proxy Sample.exe",
|
||
load "Winhttp Proxy Sample.sln" and build the project.
|
||
|
||
To build the sample using the command prompt:
|
||
=============================================
|
||
1. Open the Command Prompt window and navigate to the directory.
|
||
2. Type msbuild "Winhttp Proxy Sample.sln".
|
||
|
||
|
||
To build the sample using Visual Studio 2008 (preferred method):
|
||
================================================
|
||
1. Open Windows Explorer and navigate to the directory.
|
||
2. Double-click the icon for the .sln (solution) file to open the file in Visual Studio.
|
||
3. In the Build menu, select Build Solution. The application will be built in the default \Debug or \Release directory.
|
||
|
||
|
||
To run the sample:
|
||
==================
|
||
C:>Winhttp Proxy Sample.exe <url>
|
||
For example:
|
||
C:>Winhttp Proxy Sample.exe http://www.msn.com
|
||
Getting proxy and bypass for http://www.msn.com
|
||
|
||
Proxy: xxx.xx.xxx.xx:80;xxx.xx.xx.xx:80
|
||
Bypass: NULL
|
||
|
||
Attempting to connect to http://www.msn.com
|
||
|
||
Setting winhttp proxy to xxx.xx.xxx.xx:80;xxx.xx.xx.xx:80
|
||
|
||
Status: 200
|
||
|
||
SOURCE FILES
|
||
=============
|
||
BasicProxyMain.cpp
|
||
GetProxy.h
|
||
GetProxy.cpp
|
||
Winhttp Proxy Sample.vcproj
|
||
Winhttp Proxy Sample.sln
|
||
|
||
SEE ALSO
|
||
=========
|
||
For more information on Winhttp authentication, go to:
|
||
http://msdn.microsoft.com/en-us/library/aa384240.aspx
|
||
|
||
|
||
==================================
|
||
<EFBFBD> Microsoft Corporation
|