Skip to content

iglobalfilechangeprovider-getfilename-method.md

Latest commit

 

History

History
46 lines (34 loc) · 3.61 KB

iglobalfilechangeprovider-getfilename-method.md

File metadata and controls

46 lines (34 loc) · 3.61 KB
title IGlobalFileChangeProvider::GetFileName Method
description The IGlobalFileChangeProviderGetFileName method retrieves the full path to a file that has been changed.
ms.date 10/07/2016
ms.assetid b4aed437-7a05-404c-8069-84a816df1479

IGlobalFileChangeProvider::GetFileName Method

Retrieves the full path to a file that has been changed.

Syntax

virtual PCWSTR GetFileName(  
   VOID  
) const = 0;

Parameters

This method takes no parameters.

Return Value

A pointer to a string that contains the file path.

Remarks

When a file within the scope of a Web site is changed, [!INCLUDEiisver] generates a GL_FILE_CHANGE notification and creates an IGlobalFileChangeProvider interface that is passed to a module's CGlobalModule::OnGlobalFileChange method. When writing a module, you can use the IGlobalFileChangeProvider::GetFileName method to retrieve the full path to the file that was modified.

Example

The following code example demonstrates how to create a global-level HTTP module that uses the GetFileName method to retrieve the path to a file that has been modified. The module then writes the path of the file to a log entry in the Event Viewer.

[!code-cppIGlobalFileChangeProviderGetFileName#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

IGlobalFileChangeProvider Interface