Share via


ILogUIPlugin::OnProperties

The ILogUIPlugin::OnProperties method is invoked by IIS when the administrator clicks Properties... on the site tab of the server Properties dialog in the MMC.

Note

The ILogUIPlugin2::OnPropertiesEx method replaces the ILogUIPlugin::OnProperties method on IIS 6.0 and later.

virtual HRESULT STDMETHODCALLTYPE OnProperties(
  OLECHAR*  pocMachineName,
  OLECHAR*  pocMetabasePath
);

Parameters

  • pocMachineName
    [in] Pointer to a Unicode character array that specifies the name of the machine on which the server is running.

  • pocMetabasePath
    [in] Pointer to Unicode character array that specifies the metabase path to the Web or FTP server.

Remarks

After your implementation of ILogUIPlugin::OnProperties completes execution, IIS checks whether certain metabase keys have been written to and, if so, will reload the instance of your custom logging module that is assigned to the affected Web or FTP server. This reload, which includes invocation of the custom logging module's ILogPlugin::InitializeLog and ILogPlugin::QueryExtraLoggingFields methods, allows your logging module to re-initialize itself with any values in the metabase that might have been changed by the user interface module.

The metabase keys that IIS checks are those that begin with "Log" except for the "LogExt" metabase keys.

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in ilogobj.hxx.

See Also

Concepts

ILogPlugin::InitializeLog

ILogPlugin::QueryExtraLoggingFields

ILogUIPlugin2::OnPropertiesEx