Share via


HTTP_FILTER_ACCESS_DENIED

A version of this page is also available for

Windows Embedded CE 6.0 R3

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