IGlobalRSCAQueryProvider Interface

IIS 7.0
 

Extends the IHttpEventProvider interface by adding support for querying IIS Run-Time Status and Control information.

class IGlobalRSCAQueryProvider : public IHttpEventProvider

The following table lists the methods exposed by the IGlobalRSCAQueryProvider interface.

Name

Description

GetFunctionName

Returns the name of the dynamic function call that caused the event.

GetFunctionParameters

Returns the parameters of the dynamic function call that caused the event.

GetOutputBuffer

Creates a new BYTE array.

ResizeOutputBuffer

Resizes and returns the output BYTE array.

SetErrorStatus

(Inherited from IHttpEventProvider.)

SetResult

Finalizes the internal buffer.

This interface contains no derived classes.

CGlobalModule derived classes that register for GL_RSCA_QUERY events receive an IGlobalRscaQueryProvider pointer as a parameter on the CGlobalModule::OnGlobalRSCAQuery virtual method.

Example

The following code example demonstrates how to create a global module that listens for GL_RSCA_QUERY events. It then writes the IGlobalRSCAQueryProvider information to the Event Viewer.

System_CAPS_cautionCaution

IIS 7 generates a large number of events in the Event Viewer. To avoid a log overflow error in a production environment, you should generally avoid writing cache information to the event log. For demonstration purposes, this code example writes an entry to the Event Viewer in debug mode only.

For more information on how to create and deploy a native DLL module, see Walkthrough: Creating a Request-Level HTTP Module By Using Native Code.

The above code writes two new events to the application log of the Event Viewer, where the Data boxes contain strings similar to the following:

Function Name: PMH_App_Domain_Enum_V1
Parameters:

You can optionally compile the code by using the __stdcall (/Gz) calling convention instead of explicitly declaring the calling convention for each function.

IHttpEventProvider

   IGlobalRSCAQueryProvider

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: