ProxyFilterHttpRequest (Windows Embedded CE 6.0)
1/6/2010
The Web proxy calls this function each time it receives an HTTP request from a client.
Syntax
DWORD ProxyFilterHttpRequest(
PPROXY_HTTP_REQUEST pRequest
);
Parameters
- pRequest
[in, out] Pointer to a PROXY_HTTP_REQUEST structure.
Return Value
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
Header | webproxy.h |
Library | Developer Implemented |
Windows Embedded CE | Windows CE 5.0 and later |