Partager via

ILogUIPlugin2::OnPropertiesEx

  • Article

The ILogUIPlugin2::OnPropertiesEx 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,
  OLECHAR*  pocUserName,
  OLECHAR*  pocPassword);

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.

  • pocUserName
    [in] Pointer to Unicode character array that specifies the user name.

  • pocPassword
    [in] Pointer to Unicode character array that specifies the password.

Remarks

After your implementation of ILogUIPlugin2::OnPropertiesEx 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

Server: Requires Windows Server 2003.

Product: IIS

Header: Declared in ilogobj.hxx.

See Also

Concepts

ILogPlugin::InitializeLog

ILogPlugin::QueryExtraLoggingFields

ILogUIPlugin::OnProperties