Skip to content

Latest commit

 

History

History
49 lines (36 loc) · 3.48 KB

iglobalconfigurationchangeprovider-getchangepath-method.md

File metadata and controls

49 lines (36 loc) · 3.48 KB
Raw
title description ms.date ms.assetid
IGlobalConfigurationChangeProvider::GetChangePath Method
Describes the IGlobalConfigurationChangeProvider::GetChangePath method and provides the syntax, parameters, return value, and requirements.
10/07/2016
bafedfc8-9b20-cef2-48cb-de1d8d9c1938

IGlobalConfigurationChangeProvider::GetChangePath Method

Retrieves the path of a configuration change.

Syntax

virtual VOID GetChangePath(  
   PCWSTR* ppszPath  
) const = 0;

Parameters

ppszPath
[OUT] A pointer to a PCWSTR value.

Return Value

VOID.

Remarks

The GetChangePath method retrieves the configuration path that triggered a GL_CONFIGURATION_CHANGE notification. For example, the configuration path for the default Web site on a server running [!INCLUDEiisver] will usually resemble MACHINE/WEBROOT/APPHOST/Default Web Site.

Example

The following code example demonstrates how to create a global-level HTTP module that uses the GetChangePath method to retrieve the path for a configuration change and add a log entry to the Event Viewer.

For example, when the ApplicationHost.config file is changed by using the [!INCLUDEiismgr] application, an event that contains the configuration path will be written to the Event Viewer.

[!code-cppIGlobalConfigurationChangeProviderGetChangePath#1]

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 [!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

See Also

IGlobalConfigurationChangeProvider Interface