Skip to content

ihttpserver-notifyfilechange-method.md

Latest commit

 

History

History
52 lines (39 loc) · 3.66 KB

ihttpserver-notifyfilechange-method.md

File metadata and controls

52 lines (39 loc) · 3.66 KB
title IHttpServer::NotifyFileChange Method
description Describes the IHttpServer::NotifyFileChange method and details its syntax, parameters, return value, code example, and requirements.
ms.date 10/07/2016
ms.assetid b807132a-9aa7-73fc-06d7-ec7412ec0588

IHttpServer::NotifyFileChange Method

Triggers a notification that a file has changed.

Syntax

virtual VOID NotifyFileChange(  
   IN PCWSTR pszFileName  
) = 0;

Parameters

pszFileName
[IN] A pointer to a string that contains the path to a file.

Return Value

VOID.

Remarks

[!INCLUDEiisver] automatically triggers a GL_FILE_CHANGE notification when a file within a Web site is modified. Developers can use the NotifyFileChange method to manually trigger a GL_FILE_CHANGE notification for a file path that is specified in the pszFileName parameter.

Note

Developers can use the CGlobalModule::OnGlobalFileChange method to provide additional processing when a GL_FILE_CHANGE notification occurs.

Example

The following code example demonstrates how to use the NotifyFileChange method to create an HTTP module that manually triggers a GL_FILE_CHANGE notification for the C:\Inetpub\Wwwroot\Default.aspx file.

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

IHttpServer Interface
CGlobalModule::OnGlobalFileChange Method
Request-Processing Constants