IHttpUrlInfo::IsFrequentlyHit Method

IIS 7.0
 

Returns a Boolean value that indicates whether the URL is requested frequently.

virtual BOOL IsFrequentlyHit(
   VOID
) const = 0;

This method takes no parameters.

true if the URL is frequently requested; otherwise, false.

The IsFrequentlyHit method retrieves a Boolean value that indicates whether the URL for the current request is frequently requested by Web clients. For example, if you were writing a custom HTTP compression module for IIS 7, you could determine which URLs should be compressed based on the results of the IsFrequentlyHit method.

By default, the determining factor for a return value of true is two requests in a 10-second time span. You can configure this behavior by modifying the frequentHitThreshold and frequentHitTimePeriod attributes of the <serverRuntime> element in your ApplicationHost.config file. For example, to configure your server to return a value of true when a URL has been requested 10 times in a 5-second period, you would modify the <serverRuntime> element in your ApplicationHost.config file by adding the following attributes:

<serverRuntime
    frequentHitThreshold="10"
    frequentHitTimePeriod="00:00:05" />

Example

The following code example demonstrates how to use the IHttpContext::GetUrlInfo method to create an HTTP module that retrieves an IHttpUrlInfo interface for the current request. Then the example calls the IsFrequentlyHit method to determine whether the URL is requested frequently. Finally, the example displays this information to a Web client.

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: