Skip to content

request-notification-status-enumeration.md

Latest commit

 

History

History
48 lines (38 loc) · 3.8 KB

request-notification-status-enumeration.md

File metadata and controls

48 lines (38 loc) · 3.8 KB
title REQUEST_NOTIFICATION_STATUS Enumeration
description Learn how the REQUEST_NOTIFICATION_STATUS enumeration defines the return values for request-level notifications.
ms.date 10/07/2016
ms.assetid 318f6aef-c052-9021-b89f-fbcfe9caf014

REQUEST_NOTIFICATION_STATUS Enumeration

Defines the return values for request-level notifications.

Syntax

typedef enum REQUEST_NOTIFICATION_STATUS{  
   RQ_NOTIFICATION_CONTINUE,  
   RQ_NOTIFICATION_PENDING,  
   RQ_NOTIFICATION_FINISH_REQUEST  
};

Members

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.

Remarks

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.

[!code-cpp_RaiseEvnt#2]
[!code-cpp_RaiseEvnt#1]

Requirements

Type Description
Client - IIS 7.0 on [!INCLUDEwinvista]
- IIS 7.5 on Windows 7
- IIS 8.0 on Windows 8
- IIS 10.0 on Windows 10
Server - IIS 7.0 on [!INCLUDEwinsrv2008]
- 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
Product - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
- [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100]
Header Httpserv.h

See Also

Web Server Core Enumerations
GLOBAL_NOTIFICATION_STATUS Enumeration