ProxyFilterHttpRequest (Windows CE 5.0)

Send Feedback

The Web proxy calls this function each time it receives an HTTP request from a client.

DWORD ProxyFilterHttpRequest(  PPROXY_HTTP_REQUEST  pRequest);

Parameters

Return Values

ERROR_SUCCESS indicates success. A nonzero error value indicates failure.

Remarks

The following table shows the options provided by the Web proxy filter for filtering on a request.

Option Description
Forbid Return with an empty szURLOut member of PROXY_HTTP_REQUEST to return a 403 return code to the client.
Redirect Return with szURLOut set to a new URL to send the redirect status code to.
Allow Return with the value in szURLOut set to equal the value in szURL to allow the request to proceed.

The Web proxy can load multiple filters. If a filter returns an Allow option, the Web proxy calls into the next filter. If the filter forbids the request or signifies to redirect, the Web proxy handles the case and does not call ProxyFilterHttpRequest for any other filters.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: Webproxy.h.
Link Library: Not applicable.

See Also

Web Proxy Functions | PROXY_HTTP_REQUEST

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.