Windows 右键菜单中实现将Oracle trc文件转换为可读文件

　　做过Oracle数据库sql优化的朋友一定都知道trc文件，该文件中记录了此次会话sql执行情况的完整信息。然而该文件内容的可读性并不好，每次使用都需要利用Oracle中提供的tkprof工具在命令行中进行格式转换，如此给本来就很费脑子的sql调试带来了很多不必要的重复工作，时间久了工作效率可想而知。所以为了提高工作效率，并让sql调试过程更具乐趣，笔者利用Windows Shell在.trc文件类型的右键菜单中添加了自动利用tkprof.exe进行格式转换的菜单项，对指定.trc文件单击该菜单项后可直接弹出进行了格式转换后的sql跟踪内容。下面我就详细介绍下该功能的实现原理。

Windows Shell给用户提供了用于控制文件显示和行为的一组接口：IShellExtInit, IContextMenu, IPersistFile, IExtractIcon, IQueryInfo，其中，

IShellExtInit接口用于一次有多个选择文件时初始化的处理，其C#版本的接口定义如下(如无特别说明以下均为C#代码)：

 

[ComImport(), InterfaceType(ComInterfaceType.InterfaceIsIUnknown), GuidAttribute("000214e8-0000-0000-c000-000000000046")] 

public interface IShellExtInit 

{ 

[PreserveSig()] 

int Initialize(IntPtr pidlFolder, IntPtr lpdobj, uint /*HKEY*/ hKeyProgID); 

} 

IPersistFile接口用于一次仅有一个选择文件时初始化的处理，其接口定义如下：

 

[ComImport(), ComVisible(true), InterfaceType(ComInterfaceType.InterfaceIsIUnknown), GuidAttribute("0000010b-0000-0000-C000-000000000046")] 

 public interface IPersistFile 

{ 

[PreserveSig] 

 uint GetClassID(out Guid pClassID); 

[PreserveSig] 

 uint IsDirty(); 

[PreserveSig] 

 uint Load([In, MarshalAs(UnmanagedType.LPWStr)] string pszFileName, [In] uint dwMode); 

[PreserveSig] 

 uint Save([In, MarshalAs(UnmanagedType.LPWStr)] string pszFileName, [In] bool fRemember); 

[PreserveSig] 

 uint SaveCompleted([In, MarshalAs(UnmanagedType.LPWStr)] string pszFileName); 

[PreserveSig] 

 uint GetCurFile([MarshalAs(UnmanagedType.LPWStr)] out string ppszFileName); 

} 

 

 IContextMenu接口用于对文件自定义右键菜单项的控制，其接口定义如下：

 

[ComImport(), InterfaceType(ComInterfaceType.InterfaceIsIUnknown), GuidAttribute("000214e4-0000-0000-c000-000000000046")] 

 public interface IContextMenu 

{ 

[PreserveSig()] 

 int QueryContextMenu(HMenu hmenu, uint iMenu, uint idCmdFirst, uint idCmdLast, CMF uFlags); 

[PreserveSig()] 

 void InvokeCommand(IntPtr pici); 

[PreserveSig()] 

 void GetCommandString(uint idcmd, GCS uflags, uint reserved, IntPtr commandstring, int cchMax); 

} 

 

 IExtractIcon接口用于对文件图标的控制，其定义如下：

 

[ComVisible(true), ComImport, Guid("000214eb-0000-0000-c000-000000000046"), InterfaceType(ComInterfaceType.InterfaceIsIUnknown)] 

 public interface IExtractIcon 

{ 

[PreserveSig] 

 int GetIconLocation([In] ExtractIconOptions uFlags, 

[In] IntPtr szIconFile, 

[In] uint cchMax, 

[Out] out int piIndex, 

[Out] out ExtractIconFlags pwFlags); 

 

[PreserveSig] 

 int Extract([In, MarshalAs(UnmanagedType.LPWStr)] string pszFile, 

 uint nIconIndex, 

[Out, MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(IconMarshaler))] out Icon phiconLarge, 

[Out, MarshalAs(UnmanagedType.CustomMarshaler, MarshalTypeRef=typeof(IconMarshaler))] out Icon phiconSmall, 

[In] uint nIconSize); 

} 
 

IQueryInfo接口用于对当鼠标移至文件图标上方时弹出tip信息的控制，其定义如下：

 

[ComImport(), ComVisible(true), InterfaceType(ComInterfaceType.InterfaceIsIUnknown), GuidAttribute("00021500-0000-0000-c000-000000000046")] 

 public interface IQueryInfo 

{ 

[PreserveSig] 

 uint GetInfoTip(uint dwFlags, out IntPtr pszInfoTip); 

 

[PreserveSig] 

 uint GetInfoFlags(out uint dwFlags); 

} 
 

 用户自定义的扩展类需要实现以上这些接口，关键代码如下：

 

int IContextMenu.QueryContextMenu(HMenu hMenu, uint iMenu, uint idCmdFirst, uint idCmdLast, CMF uFlags) 

{ 

int id = 0; 

if ((uFlags & (CMF.CMF_VERBSONLY | CMF.CMF_DEFAULTONLY | CMF.CMF_NOVERBS)) == 0 || 

(uFlags & CMF.CMF_EXPLORE) != 0) 

{ 

//创建子菜单 

HMenu submenu = ShellLib.Helpers.CreatePopupMenu(); 

Helpers.AppendMenu(hMenu, MFMENU.MF_STRING, new IntPtr(idCmdFirst + id++), "可读格式"); 

//为菜单增加图标 

Bitmap bpCopy = Resource1.copy; 

Helpers.SetMenuItemBitmaps(hMenu, 0, MFMENU.MF_BYPOSITION, bpCopy.GetHbitmap(), bpCopy.GetHbitmap()); 

} 

return id; 

} 

 

void IContextMenu.GetCommandString(uint idcmd, GCS uflags, uint reserved, IntPtr commandstring, int cchMax) 

{ 

 string tip = ""; 

 

 switch (uflags) 

{ 

 case GCS.VERB: 

 break; 

 case GCS.HELPTEXTW: 

tip = "把选中的TRC转换为可读格式"; 

 break; 

 

 if (!string.IsNullOrEmpty(tip)) 

{ 

 byte[] data = new byte[cchMax * 2]; 

Encoding.Unicode.GetBytes(tip, 0, tip.Length, data, 0); 

Marshal.Copy(data, 0, commandstring, data.Length); 

} 

 break; 

} 

} 
 

 

void IContextMenu.InvokeCommand(IntPtr pici) 

{ 

INVOKECOMMANDINFO ici = (INVOKECOMMANDINFO)Marshal.PtrToStructure(pici, typeof(ShellLib.INVOKECOMMANDINFO)); 

StringBuilder sb = new StringBuilder(1024); 

StringBuilder sbAll = new StringBuilder(); 

 uint nselected; 

 

 switch (ici.verb) 

{ 

 case 0: 

 //复制文件名 
 
nselected = Helpers.DragQueryFile(m_hDrop, 0xffffffff, null, 0); 

 for (uint i = 0; i < nselected; i++) 

{ 

ShellLib.Helpers.DragQueryFile(m_hDrop, i, sb, sb.Capacity + 1); 

 string trctmpfile = System.IO.Path.GetTempFileName(); 

 string txttmpfile = System.IO.Path.GetTempFileName(); 

File.AppendAllText(trctmpfile, sb.ToString()); 

Process proc = new Process(); 

proc.StartInfo.FileName = @"tkprof.exe"; 

proc.StartInfo.Arguments = trctmpfile + " " + txttmpfile; 

proc.Start(); 

 while (!proc.HasExited) 

{ 

Application.DoEvents(); 

} 

proc.StartInfo.FileName = "NOTEPAD.EXE"; 

proc.StartInfo.Arguments = txttmpfile; 

proc.Start(); 

} 

 break; 

 default: 

break; 

} 

} 

 （注：其它代码请见附件。）

 　　也许有些细心好学的朋友要问了，Windows Shell是如何与用户自定义的Shell扩展类进行交互的呢？下面就简单介绍下Windows Shell调用用户自定义Shell扩展类的工作原理。

　　在Windows中Shell要成功调用用户自定义的Shell扩展类需要三大要素：Explorer.exe进程、注册表、自定义扩展类，其中这种Shell扩展机制的核心是注册表。在注册表的HKEY_CLASSES_ROOT中管理了两种类型的子项：一是操作系统中所有文件的扩展名，二是操作系统中的所有类型。其中"扩展名"子项主要维护了该扩展名所对应的类型以及打开具有该扩展名的文件所对应的应用程序的配置；"类型"子项主要维护了具有该类型的扩展名所对应的文件的显示和行为的配置。所以，要想实现Shell与扩展类的交互，则必须在HKEY_CLASSES_ROOT下为指定扩展名创建相应类型，并将扩展类com的guid信息配置到该类型下的各个Handler子项中。如此，当用户在用资源管理器进行文件浏览或操作时，Explorer进程首先将在注册表的HKEY_CLASSES_ROOT项下查找出该文件的扩展名配置项，然后通过在该项中配置的扩展名所属类型，在同级项中找出该类型所对应的注册表项，最后再根据"类型"项中与用户当前操作相对应的项的值(com的guid)最终找到相应的com组件，并以如上标准接口进行方法调用。

　　所以根据以上原理，在用户自定义的扩展类中还需加入RegisterServer和UnregisterServer两方法，以实现在使用RegAsm.exe工具将扩展类注册/卸载同时先后实现：1、将com组件的guid注册到Shell扩展的组件池中（或卸载）；2、注册/卸载文件扩展名及其类型配置信息。代码如下：

[System.Runtime.InteropServices.ComRegisterFunctionAttribute()]
        static void RegisterServer(String str1)
        {
            try
            {
                //注册 DLL
                RegistryKey root;
                RegistryKey rk;
                root = Registry.LocalMachine;
                rk = root.OpenSubKey("Software\\Microsoft\\Windows\\CurrentVersion\\Shell Extensions\\Approved", true);
                rk.SetValue(GUID, KEYNAME);
                rk.Close();
                root.Close();

                //注册文件
                RegTRC();
            }
            catch(Exception ex){
            }
        }

private static void RegTRC()
        {
            RegistryKey root;
            RegistryKey rk;

            root = Registry.ClassesRoot;
            rk = root.OpenSubKey(".trc");
            if (rk == null)
            {
                rk=root.CreateSubKey(".trc");
            }
                string txtclass = (string)rk.GetValue("");
                if (string.IsNullOrEmpty(txtclass))
                {
                    txtclass = "TXT";
                    rk.SetValue("", txtclass);

                }
            

            rk.Close();

            rk = root.CreateSubKey(txtclass + "\\shellex\\ContextMenuHandlers\\" + KEYNAME);
            rk.SetValue("", GUID);
            rk.Close();

            rk = root.CreateSubKey(txtclass + "\\shellex\\IconHandler");
            rk.SetValue("", GUID);
            rk.Close();

            rk = root.CreateSubKey(txtclass + "\\shellex\\{00021500-0000-0000-C000-000000000046}");
            rk.SetValue("", GUID);
            rk.Close();
        }

 

   [System.Runtime.InteropServices.ComUnregisterFunctionAttribute()]
        static void UnregisterServer(String str1)
        {
            try
            {
                //注销动态库
                RegistryKey root;
                RegistryKey rk;
                root = Registry.LocalMachine;
                rk = root.OpenSubKey("Software\\Microsoft\\Windows\\CurrentVersion\\Shell Extensions\\Approved", true);
                rk.DeleteValue(GUID);
                rk.Close();
                root.Close();

                //注销文件
                UnRegTRC();
            }
            catch
            {
            }
        }

private static void UnRegTRC()
        {
            RegistryKey root;
            RegistryKey rk;

            root = Registry.ClassesRoot;
            rk = root.OpenSubKey(".trc");
            rk.Close();
            string txtclass = (string)rk.GetValue("");
            if (!string.IsNullOrEmpty(txtclass))
            {
                root.DeleteSubKey(txtclass + "\\shellex\\ContextMenuHandlers\\" + KEYNAME);
                root.DeleteSubKey(txtclass + "\\shellex\\IconHandler");
                root.DeleteSubKey(txtclass + "\\shellex\\{00021500-0000-0000-C000-000000000046}");
            }
        }

 

 

 

 　　最后，利用在命令行中使用"regasm MyContextMenu.dll /CodeBase"命令，将dll注册到Shell中即可实现如题功能。哈哈，over!