Sets the global-level priority for a module.
[IN] A bitmask value that contains the global notifications to set for the priority level. (Defined in Httpserv.h.)
[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.
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.
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 SetPriorityForRequestNotification method sets the module's priority for request-level notifications.
The SetPriorityForGlobalNotification method 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.
The entries in the Event Viewer will display "IISADMIN" as the event source.