IHttpContext::SetRequestHandled Method

IIS 7.0
 

Indicates that the handlers for the current request have completed.

virtual VOID SetRequestHandled(
   VOID
) = 0;

This method takes no parameters.

The SetRequestHandled method specifies that the handlers for the current request have finished processing. For example, if multiple request handlers are configured for a specific file type, you can use the SetRequestHandled method to indicate that processing has completed for the current request and that additional handlers should not be executed.

Example

The following code example demonstrates how to create an HTTP module that performs the following tasks:

  1. The module registers for the RQ_PRE_EXECUTE_REQUEST_HANDLER notification.

  2. The module creates a CHttpModule class that contains an OnPreExecuteRequestHandler method.

  3. When a Web client requests a URL, IIS calls the module's OnPreExecuteRequestHandler method. This method performs the following tasks

    1. Retrieves a pointer to an IScriptMapInfo interface.

    2. Retrieves the script handler for the request by using the IScriptMapInfo::GetScriptProcessor method.

    3. If the request is for an ASP page, returns a message to the Web client that the request has been handled, and then calls the SetRequestHandled method to set the request as handled.

  4. The module removes the CHttpModule class from memory and then exits.

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