Retrieves the next notification for the current module host.
[IN] The REQUEST_NOTIFICATION_STATUS enumeration value to return from the current notification.
[OUT] A pointer to a DWORD that contains the bitmask value for the next notification.
[OUT] A pointer to a Boolean value. true to indicate that the notification is a post-notification; otherwise, false.
[OUT] A pointer to the address of the CHttpModule class that is responsible for processing the returned notification.
[OUT] A pointer to the address of the IHttpEventProvider interface for the returned notification.
true if the call to GetNextNotification was successful; otherwise, false.
HTTP modules can use the GetNextNotification method to merge notifications within the same module host. Returning processing to the integrated request-processing pipeline requires a small amount of overhead. To bypass that overhead, an HTTP module can call the GetNextNotification method to skip to the next notification and continue processing, provided that the two notifications are within the same module host and no additional notification handlers are registered to process a request between notifications.
For example, an HTTP module might contain an OnResolveRequestCache method, and another HTTP module within the same module host might contain an OnPostResolveRequestCache method. The first module can call the GetNextNotification method to continue processing, rather than returning processing to the pipeline, as though the module had already registered for the OnPostResolveRequestCache post-event notification method.
If the call to GetNextNotification returns false, you can enable a failed-request-tracing rule that will allow you to examine which notifications IIS is processing.
The following code example demonstrates how to create an HTTP module that performs the following tasks:
Registers for several notifications.
Creates a helper method that calls the GetNextNotification method, which attempts to skip to the next notification.
For each registered notification, defines notification handlers that call the helper method, and then displays the return status to the client.