IHttpContext::GetIsLastNotification Method

IHttpContext::GetIsLastNotification Method

IIS 7.0
 

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

virtual BOOL GetIsLastNotification(
   IN REQUEST_NOTIFICATION_STATUS status
) = 0;

status

[IN] A REQUEST_NOTIFICATION_STATUS enumeration value.

true if additional notifications are pending; otherwise, false.

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.

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