| title | IHttpModuleRegistrationInfo::SetPriorityForGlobalNotification Method |
|---|---|
| description | The IHttpModuleRegistrationInfoSetPriorityForGlobalNotification method sets the global-level priority for a module. |
| ms.date | 10/07/2016 |
| ms.assetid | ad47de99-e784-6394-0193-696bfdc3e89d |
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.
Note
The bitmask values for global-level notifications and priority aliases are defined in the Httpserv.h file.
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 SetRequestNotifications method registers a CHttpModule class for a request-level OnBeginRequest notification.
-
The SetPriorityForRequestNotification method sets the module's priority for request-level notifications.
-
The SetGlobalNotifications method registers a CGlobalModule class for a global-level OnGlobalPreBeginRequest notification.
-
The
SetPriorityForGlobalNotificationmethod sets the module's priority for global-level notification.The module responds to the registered notifications and writes entries to the application log in the Event Viewer.
Note
The entries in the Event Viewer will display "IISADMIN" as the event source.
[!code-cppIHttpModuleRegistrationInfoSetPriorityForGlobalNotification#1]
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.
| Type | Description |
|---|---|
| Client | - IIS 7.0 on [!INCLUDEwinvista] - IIS 7.5 on Windows 7 - IIS 8.0 on Windows 8 - IIS 10.0 on Windows 10 |
| Server | - IIS 7.0 on [!INCLUDEwinsrv2008] - 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 |
| Product | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - [!INCLUDEiisexp75], [!INCLUDEiisexp80], [!INCLUDEiisexp100] |
| Header | Httpserv.h |
IHttpModuleRegistrationInfo Interface
IHttpModuleRegistrationInfo::SetGlobalNotifications Method
IHttpModuleRegistrationInfo::SetPriorityForRequestNotification Method
IHttpModuleRegistrationInfo::SetRequestNotifications Method
PFN_REGISTERMODULE Function