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

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

See Also

Reference

Web Proxy Functions
PROXY_HTTP_REQUEST