Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This structure contains access denied information for an ISAPI filter. A pointer to this structure is provided when a user is presented with an Access Denied error message. If your filter should be notified, it should register for the SF_NOTIFY_ACCESS_DENIED event.

Syntax

typedef struct _HTTP_FILTER_ACCESS_DENIED{
  const CHAR* 
pszURL;
  const CHAR* 
pszPhysicalPath;
  DWORD 
dwReason;
} HTTP_FILTER_ACCESS_DENIED, *PHTTP_FILTER_ACCESS_DENIED;

Members

pszURL

Pointer to a null-terminated string that specifies the URL that requested access to the resource.

pszPhysicalPath

The physical path of the resource that was requested.

dwReason

Flags that indicate the reasons for the denial. The following table describes the possible values.

Value Description

SF_DENIED_LOGON

The client could not be logged on.

SF_DENIED_RESOURCE

A Windows DACL denied the resource.

SF_DENIED_FILTER

An ISAPI filter denied the request.

SF_DENIED_APPLICATION

An ISAPI extension or CGI application denied the request.

SF_DENIED_BY_CONFIG

The server configuration denied the request. For example, disabling anonymous requests on the server would generate this filter notification when a user without credentials tried to make a request to the server.

Remarks

This structure indicates that the server has denied access to the requested resource. The structure is generated when there has been a logon failure, or if a user requests a resource that has an associated discretionary access control list that does not include the logged-on user.

The server will automatically include the supported authentication schemes when an ISAPI extension, filter, or CGI script returns a 401 Access Denied error code.

Requirements

Header httpfilt.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

HttpFilterProc