如何使用SHCreateItemFromParsingName处理来自Shell命名空间的名称？

Question

我正在使用 SHCreateItemFromParsingName 将一个 路径 转换为 IShellItem:

IShellItem ParseName(String path)
{
    IShellItem shellItem;

    HRESULT hr = SHCreateItemFromParsingName(path, null, IShellItem, out shellItem);
    if (Failed(hr)) 
        throw new ECOMException(hr);
    return shellItem;
}

注意：大约在2006年左右引入了一个名为IShellItem的东西，它提供了一个方便的包装器，用于封装Windows 95时代的IShellFolder+pidl结构。您甚至可以使用IParentAndItem.GetParentAndItem接口和方法要求IShellItem呕出其底层的IShellFolder和pidl。

不同的事物有不同的显示名称

我可以获取一些在shell命名空间中广为人知的位置，并查看它们的绝对解析（SIGDN_DESKTOPABSOLUTEPARSING）和编辑（SIGDN_DESKTOPABSOLUTEEDITING）显示名称：

路径	编辑	解析
C:\	"C:"	"C:"
C:\Windows	"C:\Windows"	"C:\Windows"
桌面	"桌面"	"C:\Users\Ian\Desktop"
此电脑	"此电脑"	"::{20D04FE0-3AEA-1069-A2D8-08002B30309D}"
回收站	"回收站"	"::{645FF040-5081-101B-9F08-00AA002F954E}"
文档库	"库\文档"	"::{031E4825-7B94-4DC3-B131-E946B44C8DD5}\Documents.library-ms" "
启动项	"C:\Users\Ian\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"	"C:\Users\Ian\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"

当用户在其中输入文本时如何解析它们？

我可以使用 IFileOpenDialog 让用户选择其中一个文件夹。但我真的希望用户能够 键入

• "C:\Users"
• "C:\Windows\Fonts"
• "This PC"
• "Recycle Bin"
• "Libraries"
• "Startup"
• "Fonts"

并将其解析为 IShellItem。

问题是，SHCreateItemFromParsingName 无法解析其中一些路径：

• SHCreateItemFromParsingName("C:\"): 解析
• SHCreateItemFromParsingName("C:\Windows"): 解析
• SHCreateItemFromParsingName(""): 解析（但变成"This PC"）
• SHCreateItemFromParsingName("This PC"): 失败
• SHCreateItemFromParsingName("Recycle Bin"): 失败
• SHCreateItemFromParsingName("Libraries"): 失败
• SHCreateItemFromParsingName("OneDrive"): 失败
• SHCreateItemFromParsingName("Libraries\Documents"): 失败
• SHCreateItemFromParsingName("Network"): 失败
• SHCreateItemFromParsingName("Startup"): 失败

与此同时，我的程序使用的控件可以很好地解析它们：

我该如何解析用户可能键入的各种特殊shell名称（Windows资源管理器和IFileOpen对话框可以解析）以便为该文件夹创建一个IShellItem？

真正的问题是，我希望用户能够拥有一个包含以下内容的最近使用列表：

• C:\Windows
• 回收站
• 此电脑

并且以后能够解析它们。

- Ian Boyd

---

请注意，所有失败的事情都立即在桌面下面。我猜测资源管理器在桌面文件夹上使用了 IShellFolder::ParseDisplayName。 - Jonathan Potter

这基本上是未解决的 http://stackoverflow.com/q/37000602/3501 的一个重复问题，但我认为这个问题的质量更高。 - Anders

那些不是解析名称，它们是显示名称。 - Raymond Chen

@RaymondChen，您是在说 SHParseDisplayName 能够解析这些内容，还是资源管理器做了额外的工作？ - Anders

资源管理器正在做额外的工作。基本上，它正在寻找一个与用户输入值匹配的子级显示名称。SHParseDisplayName只能解析旨在解析回来的名称（SHGDN_FORPARSING）。如果您要求一个显示名称，则找到它的唯一方法是寻找匹配项。（您可以拥有多个具有相同显示名称的项目。显示名称是模糊的。） - Raymond Chen

Answer 1

如果能调试Explorer并查看其如何执行将会很有趣。

我的建议是：如果初始解析失败，请在路径字符串前加上shell:，然后使用SHParseDisplayName再次尝试解析。如果在绑定上下文中设置STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS，还可以绑定到特殊文件。shell:协议能够解析特殊/已知文件夹的内部/规范名称，但我不知道它是否也检查显示名称。

编辑：

我现在有机会玩一下了，发现添加shell:前缀并没有太大的改进，因为它只检查已知文件夹的规范名称：

PCWSTR paths[] = {
    TEXT("C:\\"),
    TEXT("C:\\Windows"),
    TEXT(""),
    TEXT("This PC"),
    TEXT("MyComputerFolder"), // Canonical KF name
    TEXT("Recycle Bin"),
    TEXT("RecycleBinFolder"), // Canonical KF name
    TEXT("Libraries"),
    TEXT("OneDrive"),
    TEXT("Libraries\\Documents"),
    TEXT("Network"),
    TEXT("NetworkPlacesFolder"), // Canonical KF name
    TEXT("Startup"),
};

OleInitialize(0);
INT pad = 0, fill, i;
for (i = 0; i < ARRAYSIZE(paths); ++i) pad = max(pad, lstrlen(paths[i]));
for (i = 1, fill = printf("%-*s | Original | shell:   |\n", pad, ""); i < fill; ++i) printf("-"); printf("\n");
for (i = 0; i < ARRAYSIZE(paths); ++i)
{
    WCHAR buf[MAX_PATH], *p1 = NULL, *p2 = NULL;
    IShellItem*pSI;
    HRESULT hr = SHCreateItemFromParsingName(paths[i], NULL, IID_IShellItem, (void**) &pSI);
    if (SUCCEEDED(hr)) pSI->GetDisplayName(SIGDN_DESKTOPABSOLUTEPARSING, &p1), pSI->Release();
    wsprintf(buf, L"shell:%s", paths[i]);
    HRESULT hr2 = SHCreateItemFromParsingName(buf, NULL, IID_IShellItem, (void**) &pSI);
    if (SUCCEEDED(hr2)) pSI->GetDisplayName(SIGDN_DESKTOPABSOLUTEPARSING, &p2), pSI->Release();
    wprintf(L"%-*s | %.8x | %.8x | %s\n", pad, paths[i], hr, hr2, p2 && *p2 ? p2 : p1 ? p1 : L"");
    CoTaskMemFree(p1), CoTaskMemFree(p2);
}

给我这个输出：

                    | Original | shell:   |
-------------------------------------------
C:\                 | 00000000 | 80070003 | C:\
C:\Windows          | 00000000 | 80070003 | C:\Windows
                    | 00000000 | 80070003 | ::{20D04FE0-3AEA-1069-A2D8-08002B30309D}
This PC             | 80070002 | 80070003 | 
MyComputerFolder    | 80070002 | 00000000 | ::{20D04FE0-3AEA-1069-A2D8-08002B30309D}
Recycle Bin         | 80070002 | 80070003 | 
RecycleBinFolder    | 80070002 | 00000000 | ::{645FF040-5081-101B-9F08-00AA002F954E}
Libraries           | 80070002 | 00000000 | ::{031E4825-7B94-4DC3-B131-E946B44C8DD5}
OneDrive            | 80070002 | 80070003 | 
Libraries\Documents | 80070002 | 80070002 | 
Network             | 80070002 | 80070003 | 
NetworkPlacesFolder | 80070002 | 00000000 | ::{F02C1A0D-BE21-4350-88B0-7367FC96EF3C}
Startup             | 80070002 | 00000000 | C:\Users\Anders\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup

在Windows 8中，SHCreateItemFromParsingName 调用 SHParseDisplayName（使用 STR_PARSE_AND_CREATE_ITEM 和 STR_PARSE_TRANSLATE_ALIASES），所以即使是微软也难以分离解析和显示名称的API。

如果想要避免未记录的接口，则需要添加第三个步骤，在其中检查已知文件夹的显示名称。或者，正如Raymond Chen在评论中建议的那样，手动解析每个路径组件，对比该IShellFolder中的项目显示名称。

- Anders

Answer 2

有趣的是，调试Explorer并查看它是如何实现的。

从Windows 7 shell开始使用下一个未记录的接口（直到最新的Win 10之前都没有改变）。

MIDL_INTERFACE("88DF9332-6ADB-4604-8218-508673EF7F8A") IShellUrl : public IUnknown
{
    virtual HRESULT STDMETHODCALLTYPE ParseFromOutsideSource(PCWSTR,DWORD);
    virtual HRESULT STDMETHODCALLTYPE GetUrl(PWSTR,DWORD);
    virtual HRESULT STDMETHODCALLTYPE SetUrl(PCWSTR,DWORD);
    virtual HRESULT STDMETHODCALLTYPE GetDisplayName(PWSTR,DWORD);
    virtual HRESULT STDMETHODCALLTYPE GetPidl(ITEMIDLIST_ABSOLUTE * *);
    virtual HRESULT STDMETHODCALLTYPE SetPidl(ITEMIDLIST_ABSOLUTE const *);
    virtual HRESULT STDMETHODCALLTYPE SetPidlAndArgs(ITEMIDLIST_ABSOLUTE const *,PCWSTR);
    virtual PWSTR STDMETHODCALLTYPE GetArgs();
    virtual HRESULT STDMETHODCALLTYPE AddPath(ITEMIDLIST_ABSOLUTE const *);
    virtual void STDMETHODCALLTYPE SetCancelObject(ICancelMethodCalls *);
    virtual HRESULT STDMETHODCALLTYPE StartAsyncPathParse(HWND,PCWSTR,DWORD,ICancelMethodCalls *);
    virtual HRESULT STDMETHODCALLTYPE GetParseResult();
    virtual HRESULT STDMETHODCALLTYPE SetRequestID(int);
    virtual HRESULT STDMETHODCALLTYPE GetRequestID(int *);
    virtual HRESULT STDMETHODCALLTYPE SetNavFlags(int,int);
    virtual HRESULT STDMETHODCALLTYPE GetNavFlags(long *);
    virtual HRESULT STDMETHODCALLTYPE Execute(struct IShellNavigationTarget *,int *,DWORD);
    virtual HRESULT STDMETHODCALLTYPE SetCurrentWorkingDir(ITEMIDLIST_ABSOLUTE const *);
    virtual void STDMETHODCALLTYPE SetMessageBoxParent(HWND);
    virtual HRESULT STDMETHODCALLTYPE GetPidlNoGenerate(ITEMIDLIST_ABSOLUTE * *);
    virtual DWORD STDMETHODCALLTYPE GetStandardParsingFlags(BOOL);
};

class DECLSPEC_UUID("4BEC2015-BFA1-42FA-9C0C-59431BBE880E") ShellUrl;

我们可以使用它来解析显示名称，例如回收站，此电脑等（IFileOpenDialog对话框使用它）。

我们可以同步或异步使用它。对于同步，需要调用

ParseFromOutsideSource(L"your name", flags = GetStandardParsingFlags(0))

如果此调用成功，我们可以通过调用GetPidl获取并使用ITEMIDLIST_ABSOLUTE*（当不再需要时，请使用ILFree释放它），如果文件系统路径存在，则可以通过GetUrl获取它，否则返回原始名称。

还可以使用异步解析-您需要调用StartAsyncPathParse-传递自己的hwnd和可选的ICancelMethodCalls接口。当操作完成时，shell会向您的窗口发送RegisterWindowMessage(L"AC_ParseComplete")（wParam == IShellUrl*，lParam == 0）。您可以通过调用GetParseResult()获取最终状态，如果它正常，则使用GetPidl

同步解析的代码示例：

HRESULT ParsePath(PCWSTR path, IShellItem **ppsi)
{
    IShellUrl* pShUrl;

    HRESULT hr = CoCreateInstance(__uuidof(ShellUrl), NULL, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&pShUrl));

    if (hr == S_OK)
    {
        if (SUCCEEDED(hr = pShUrl->ParseFromOutsideSource(path, pShUrl->GetStandardParsingFlags(TRUE))))
        {
            ITEMIDLIST_ABSOLUTE *pidl;

            if (SUCCEEDED(hr = pShUrl->GetPidl(&pidl)))
            {
                hr = SHCreateItemFromIDList(pidl, IID_PPV_ARGS(ppsi));

                //WCHAR sz[MAX_PATH];
                //if (SUCCEEDED(pShUrl->GetUrl(sz, RTL_NUMBER_OF(sz)))) DbgPrint(">%S\n", sz);

                ILFree(pidl);
            }
        }

        pShUrl->Release();
    }

    return hr;
}

void tt(PCWSTR path)
{
    IShellItem *psi;

    if (0 <= ParsePath(path, &psi))
    {
        PWSTR szName;

        if (S_OK == psi->GetDisplayName(SIGDN_NORMALDISPLAY, &szName))
        {
            DbgPrint("NORMALDISPLAY>%S\n", szName);
            CoTaskMemFree(szName);
        }

        if (S_OK == psi->GetDisplayName(SIGDN_FILESYSPATH, &szName))
        {
            DbgPrint("FILESYSPATH>%S\n", szName);
            CoTaskMemFree(szName);
        }

        psi->Release();
    }
}

void tt()
{
    if (0 <= CoInitialize(0))
    {
        tt(L"Recycle Bin");
        tt(L"Startup");
        CoUninitialize();
    }
}

- RbMm

Answer 3

对于 Windows 10，IShellUrl GUID 是不同的：("4F33718D-BAE1-4F9B-96F2-D2A16E683346")

- Chet Chet