IGlobalFileChangeProvider::GetFileName (Método)
Recupera la ruta de acceso completa a un archivo que se ha cambiado.
Sintaxis
virtual PCWSTR GetFileName(
VOID
) const = 0;
Parámetros
Este método no toma parámetros.
Valor devuelto
Puntero a una cadena que contiene la ruta de acceso del archivo.
Comentarios
Cuando se cambia un archivo dentro del ámbito de un sitio web, IIS 7 genera una notificación GL_FILE_CHANGE y crea una interfaz IGlobalFileChangeProvider que se pasa al método CGlobalModule::OnGlobalFileChange de un módulo. Al escribir un módulo, puede usar el método IGlobalFileChangeProvider::GetFileName para recuperar la ruta de acceso completa al archivo que se modificó.
Ejemplo
En el ejemplo de código siguiente se muestra cómo crear un módulo HTTP de nivel global que usa el GetFileName
método para recuperar la ruta de acceso a un archivo que se ha modificado. A continuación, el módulo escribe la ruta de acceso del archivo en una entrada de registro del Visor de eventos.
#define _WINSOCKAPI_
#include <windows.h>
#include <sal.h>
#include <httpserv.h>
// Create the module's global class.
class MyGlobalModule : public CGlobalModule
{
public:
GLOBAL_NOTIFICATION_STATUS
OnGlobalFileChange(
IN IGlobalFileChangeProvider * pProvider
)
{
// Test for an error.
if (NULL != m_pHttpContext)
{
// Retrieve the file name.
PCWSTR pwszFileName = pProvider->GetFileName();
// Test for an error.
if (NULL != pwszFileName)
{
// Allocate storage for the file name.
char * pszFileName =
(char *) m_pHttpContext->AllocateRequestMemory(
(DWORD) wcslen(pwszFileName)+1 );
// Test for an error.
if (NULL != pszFileName)
{
// Convert the file name.
wcstombs(pszFileName,pwszFileName,
wcslen(pwszFileName));
// Create an array of strings.
LPCSTR szBuffer[2] = {"File Name"};
// Store the file name.
szBuffer[1] = pszFileName;
// Write the strings to the Event Viewer.
WriteEventViewerLog(szBuffer,2);
}
}
}
// Return processing to the pipeline.
return GL_NOTIFICATION_CONTINUE;
}
GLOBAL_NOTIFICATION_STATUS
OnGlobalPreBeginRequest(
IN IPreBeginRequestProvider * pProvider
)
{
// Retrieve a pointer to the context.
m_pHttpContext = pProvider->GetHttpContext();
// Return processing to the pipeline.
return GL_NOTIFICATION_CONTINUE;
}
VOID Terminate()
{
// Remove the class from memory.
delete this;
}
MyGlobalModule()
{
// Open a handle to the Event Viewer.
MyGlobalModule::m_hEventLog = RegisterEventSource( NULL,"IISADMIN" );
// Initialize the context pointer to NULL.
MyGlobalModule::m_pHttpContext = NULL;
}
~MyGlobalModule()
{
// Test whether the handle for the Event Viewer is open.
if (NULL != MyGlobalModule::m_hEventLog)
{
DeregisterEventSource( MyGlobalModule::m_hEventLog );
MyGlobalModule::m_hEventLog = NULL;
MyGlobalModule::m_pHttpContext = NULL;
}
}
private:
// Create a handle for the event viewer.
HANDLE m_hEventLog;
// Create a pointer for the module context.
IHttpContext * m_pHttpContext;
// Define a method that writes to the Event Viewer.
BOOL WriteEventViewerLog(LPCSTR szBuffer[], WORD wNumStrings)
{
// Test whether the handle for the Event Viewer is open.
if (NULL != MyGlobalModule::m_hEventLog)
{
// Write any strings to the Event Viewer and return.
return ReportEvent(
MyGlobalModule::m_hEventLog,
EVENTLOG_INFORMATION_TYPE,
0, 0, NULL, wNumStrings,
0, szBuffer, NULL );
}
return FALSE;
}
};
// Create the module's exported registration function.
HRESULT
__stdcall
RegisterModule(
DWORD dwServerVersion,
IHttpModuleRegistrationInfo * pModuleInfo,
IHttpServer * pGlobalInfo
)
{
UNREFERENCED_PARAMETER( dwServerVersion );
UNREFERENCED_PARAMETER( pGlobalInfo );
// Create an instance of the global module class.
MyGlobalModule * pGlobalModule = new MyGlobalModule;
// Test for an error.
if (NULL == pGlobalModule)
{
return HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY);
}
// Set the global notifications and exit.
return pModuleInfo->SetGlobalNotifications(
pGlobalModule, GL_FILE_CHANGE | GL_PRE_BEGIN_REQUEST );
}
El módulo debe exportar la función RegisterModule . Puede exportar esta función mediante la creación de un archivo de definición de módulo (.def) para el proyecto, o bien puede compilar el módulo mediante el /EXPORT:RegisterModule
modificador . Para obtener más información, vea Tutorial: Creación de un módulo HTTP de Request-Level mediante código nativo.
Opcionalmente, puede compilar el código mediante la __stdcall (/Gz)
convención de llamada en lugar de declarar explícitamente la convención de llamada para cada función.
Requisitos
Tipo | Descripción |
---|---|
Remoto | - IIS 7.0 en Windows Vista - IIS 7.5 en Windows 7 - IIS 8.0 en Windows 8 - IIS 10.0 en Windows 10 |
Servidor | - IIS 7.0 en Windows Server 2008 - IIS 7.5 en Windows Server 2008 R2 - IIS 8.0 en Windows Server 2012 - IIS 8.5 en Windows Server 2012 R2 - IIS 10.0 en Windows Server 2016 |
Producto | - 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 |
Encabezado | Httpserv.h |