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. |
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 |