SAMPLE: ROTCLEAN: Tool to Remove Stale Monikers from ROT

• Microsoft OLE libraries included with:

      - Microsoft Windows NT 3.51
      - Microsoft Windows 95
  

SUMMARY

ROTCLEAN is a tool to remove stale monikers from the OLE Running Object Table (ROT) in Windows 95 and Windows NT 3.51. To obtain ROTCLEAN:

Download ROTCLN32.EXE, a self-extracting file, from the Microsoft Software Library (MSL) on the following services:

• The Microsoft Network

        On the Edit menu, click Go To, and then click Other Location
        Type mssupport
        Double-click the MS Software Library icon
        Find the appropriate product area
        Download ROTCLN32.EXE (size: 65949 bytes) 
  

• Microsoft Download Service (MSDL)

        Dial (206) 936-6735 to connect to MSDL
        Download ROTCLN32.EXE (size: 65949 bytes) 
  

• Internet (anonymous FTP)

        ftp ftp.microsoft.com
        Change to the Softlib\Mslfiles directory
        Get ROTCLN32.EXE (size: 65949 bytes) 
  

MORE INFORMATION

An application may terminate unexpectedly before removing monikers that it may have registered in the ROT. The stale monikers that it leaves in the ROT will not correspond to running objects. Stale monikers in the ROT will not affect the binding of a moniker because OLE will never return the object that corresponds to a stale moniker. Therefore an application need not worry about removing its stale monikers from the ROT if it unexpectedly terminates.

For example, if the ROT has two objects with the same moniker and if one of the objects unexpectedly terminates, IRunningObjectTable::GetObject will return the the other object. If another valid object with the same moniker does not exist, IRunningObjectTable::GetObject will return MK_E_UNAVAILABLE.

A tool like ROTCLEAN that removes stale monikers from the ROT is useful in debugging situations. Otherwise the system will have to be rebooted to clean the ROT. ROTCLEAN uses a technique that may not work in future versions, so source code is not included or available. Moreover the technique may cause some buggy applications to shutdown prematurely. ROTCLEAN will not work in Windows 3.x.