IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification Method

IIS 7.0
 

Sets the global-level priority for a module.

virtual HRESULT SetPriorityForGlobalNotification(
   IN DWORD dwGlobalNotification,
   IN PCWSTR pszPriority
) = 0;

dwGlobalNotification

[IN] A bitmask value that contains the global notifications to set for the priority level. (Defined in Httpserv.h.)

pszPriority

[IN] A pointer to a string that contains the priority alias. (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.

The SetPriorityForGlobalNotification method sets the priority level for a list of global-level notifications for which an HTTP module has registered. IIS uses the priority level to determine the order within a notification that modules should be organized. For example, a global module that has registered for the OnGlobalPreBeginRequest notification by using the PRIORITY_ALIAS_HIGH alias would be prioritized before a module that has registered for the OnGlobalPreBeginRequest notification by using the PRIORITY_ALIAS_LOW alias.

System_CAPS_noteNote

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

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: