Skip to content

ihttpcontext-getislastnotification-method.md

Latest commit

 

History

History
51 lines (38 loc) · 4.38 KB

ihttpcontext-getislastnotification-method.md

File metadata and controls

51 lines (38 loc) · 4.38 KB
title IHttpContext::GetIsLastNotification Method
description Learn how the GetIsLastNotification method indicates whether more notifications are pending for this request within the current module host.
ms.date 10/07/2016
ms.assetid 6e2375e4-264e-ccdb-6fee-3f07d258ca3b

IHttpContext::GetIsLastNotification Method

Indicates whether more notifications are pending for this request within the current module host.

Syntax

virtual BOOL GetIsLastNotification(  
   IN REQUEST_NOTIFICATION_STATUS status  
) = 0;

Parameters

status
[IN] A REQUEST_NOTIFICATION_STATUS enumeration value.

Return Value

true if additional notifications are pending; otherwise, false.

Remarks

The GetIsLastNotification method retrieves the status of pending notifications for the current request within the current module host. That is, the GetIsLastNotification method does not indicate whether additional notifications are pending for another request, or whether additional notifications are pending for a module that is executing in a different module host.

The value of the status parameter directly affects the return value for the GetIsLastNotification method. For example, specifying RQ_NOTIFICATION_CONTINUE may return true to indicate that additional notifications are pending, whereas specifying RQ_NOTIFICATION_FINISH_REQUEST may return false for the same request. This behavior occurs because a status value of RQ_NOTIFICATION_CONTINUE will continue to process additional notifications that a status value of RQ_NOTIFICATION_FINISH_REQUEST would bypass.

Example

The following code example demonstrates how to use the GetIsLastNotification method to create an HTTP module that indicates whether more notifications are pending for the current request. Then module then returns that information to the Web client.

[!code-cppIHttpContextGetIsLastNotification#1]

Your module must export the RegisterModule function. You can export this function by creating a module definition (.def) file for your project, or you can compile the module by using the /EXPORT:RegisterModule switch. For more information, see Walkthrough: Creating a Request-Level HTTP Module By Using Native Code.

You can compile the code by using the __stdcall (/Gz) calling convention instead of explicitly declaring the calling convention for each function.

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

IHttpContext Interface
IHttpContext::DisableNotifications Method
IHttpContext::GetNextNotification Method