GLOBAL_NOTIFICATION_STATUS Enumeration

IIS 7.0
 

Defines the return values for global-level notifications.

typedef enum GLOBAL_NOTIFICATION_STATUS{
   GL_NOTIFICATION_CONTINUE,
   GL_NOTIFICATION_HANDLED
};

Member name

Description

GL_NOTIFICATION_CONTINUE

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

GL_NOTIFICATION_HANDLED

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

The members of the GLOBAL_NOTIFICATION_STATUS enumeration are used as return values from global-level notifications, and the members help to control process flow within the global-level notification processing pipeline. For example, returning GL_NOTIFICATION_CONTINUE from a global-level notification handler instructs IIS to continue processing additional global-level notifications, whereas returning GL_NOTIFICATION_HANDLED from a global-level notification handler informs IIS that global-level processing is complete and IIS should not process additional global-level notifications.

Example

The following code example demonstrates how to create a simple "Hello World" global-level HTTP module. The module defines an exported RegisterModule function that creates an instance of a class that is derived from CGlobalModule. If the class cannot be created, the function exits with an error code; otherwise, the function calls the IHttpModuleRegistrationInfo::SetRequestNotifications method to register for the GL_PRE_BEGIN_REQUEST notification.

When a GL_PRE_BEGIN_REQUEST notification occurs, IIS calls the module's CGlobalModule::OnGlobalPreBeginRequest method to process the notification. The method calls a private method to write an event to the application log of the Event Viewer, and then it returns GL_NOTIFICATION_CONTINUE to notify IIS to continue processing other notifications. When processing is complete, IIS calls the module's CGlobalModule::Terminate method to remove the class from memory.

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 Global-Level HTTP Module By Using Native Code.

You can optionally 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: