TechNet
Export (0) Print
Expand All

REQUEST_NOTIFICATION_STATUS Enumeration

IIS 7.0
 

Defines the return values for request-level notifications.

typedef enum REQUEST_NOTIFICATION_STATUS{
   RQ_NOTIFICATION_CONTINUE,
   RQ_NOTIFICATION_PENDING,
   RQ_NOTIFICATION_FINISH_REQUEST
};

Member name

Description

RQ_NOTIFICATION_CONTINUE

Indicates that IIS should continue processing additional request-level notifications.

RQ_NOTIFICATION_PENDING

Indicates that an asynchronous notification is pending and returns request-level processing to IIS.

RQ_NOTIFICATION_FINISH_REQUEST

Indicates that IIS has finished processing request-level notifications and should not process any additional request-level notifications.

The members of the REQUEST_NOTIFICATION_STATUS enumeration are used as return values from request-level notifications, and the members help to control process flow within the integrated request-processing pipeline. For example, returning RQ_NOTIFICATION_CONTINUE from a request-level notification handler instructs IIS to continue processing additional request-level notifications, whereas returning RQ_NOTIFICATION_FINISH_REQUEST from a request-level notification handler informs IIS that request-level processing is complete and IIS should not process additional request-level notifications. Modules that implement request handling should return RQ_NOTIFICATION_FINISH_REQUEST when an error occurs.

Example

The following example implements a RQ_BEGIN_REQUEST handler. If the request is not an HTML file, the example returns RQ_NOTIFICATION_CONTINUE and normal processing occurs. When the counter value has a zero remainder, the requested file is replaced by a string returned by the IHttpResponse::WriteEntityChunkByReference method and the example returns RQ_NOTIFICATION_FINISH_REQUEST. If an error occurs, the example logs the error and returns RQ_NOTIFICATION_FINISH_REQUEST.

Requirements

Type

Description

Client

  • IIS 7.0 on Windows Vista

  • IIS 7.5 on Windows 7

  • IIS 8.0 on Windows 8

  • IIS 10.0 on Windows 10

Server

  • IIS 7.0 on Windows Server 2008

  • IIS 7.5 on Windows Server 2008 R2

  • IIS 8.0 on Windows Server 2012

  • IIS 8.5 on Windows Server 2012 R2

  • IIS 10.0 on Windows Server 2016 Technical Preview

Product

  • IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0

  • IIS Express 7.5, IIS Express 8.0, IIS Express 10.0

Header

Httpserv.h

Show:
© 2016 Microsoft