IHttpModuleRegistrationInfo::SetGlobalNotifications Method

IIS 7.0
 

Registers the global-level notifications for a module.

virtual HRESULT SetGlobalNotifications(
   IN CGlobalModule* pGlobalModule,
   IN DWORD dwGlobalNotifications
) = 0;

pGlobalModule

[IN] A pointer to a CGlobalModule class.

dwGlobalNotifications

[IN] A bitmask value that contains the global notifications to register. (Defined in Httpserv.h.)

An HRESULT. Possible values include, but are not limited to, those in the following table.

Value

Description

S_OK

Indicates that the operation was successful.

ERROR_ALREADY_EXISTS

Indicates that the module has already been registered.

The SetGlobalNotifications method registers the request-level notifications for a CGlobalModule class.

System_CAPS_noteNote

The bitmask values for global-level notifications are defined in the Httpserv.h file.

The SetGlobalNotifications method requires a pointer to a CGlobalModule class, and IIS will automatically create an instance of that class.

System_CAPS_noteNote

The CGlobalModule class must define a Terminate method.

Example

The following code example demonstrates how to create an HTTP module that uses the RegisterModule function and the following methods to register a module for global-level and request-level notifications.

The module responds to the registered notifications and writes entries to the application log in the Event Viewer.

System_CAPS_noteNote

The entries in the Event Viewer will display "IISADMIN" as the event source.

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