| title | IGlobalRSCAQueryProvider Interface |
|---|---|
| description | Describes the IGlobalRSCAQueryProvider interface and details its syntax, methods, derived classes, remarks, inheritance hierarchy, and requirements. |
| ms.date | 10/07/2016 |
| ms.assetid | b4d97a23-123d-5c77-b0f1-ccfc388d5517 |
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::OnGlobalRSCAQueryvirtual method.
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.
Caution
[!INCLUDEiisver] 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.
[!code-cppIGlobalRSCAQueryProvider#1]
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.
IGlobalRSCAQueryProvider
| 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 |