如何将 SHCreateItemFromParsingName 与来自 shell 命名空间的名称一起使用？

Question

我正在使用 SHCreateItemFromParsingName to turn a path into a IShellItem:

IShellItem ParseName(String path)
{
    IShellItem shellItem;

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

Note: A IShellItem was introduced around 2006 to provide a handy wrapper around the Windows 95-era IShellFolder+pidl constructs. You can even ask a IShellItem to cough up it's underlying IShellFolder and pidl with the IParentAndItem.GetParentAndItem interface and method.

不同的东西有不同的显示名称

我可以在 shell 命名空间中找到一些众所周知的位置，并查看它们的绝对 parsing (SIGDN_DESKTOPABSOLUTEPARSING) 和 正在编辑 (SIGDN_DESKTOPABSOLUTEEDITING) 显示名称：

Path	Editing	Parsing
C:\	"C:"	"C:"
C:\Windows	"C:\Windows"	"C:\Windows"
Desktop	"Desktop"	"C:\Users\Ian\Desktop"
Computer	"This PC"	"::{20D04FE0-3AEA-1069-A2D8-08002B30309D}"
Recycle Bin	"Recycle Bin"	"::{645FF040-5081-101B-9F08-00AA002F954E}"
Documents Library	"Libraries\Documents"	"::{031E4825-7B94-4DC3-B131-E946B44C8DD5}\Documents.library-ms" "
Startup	"C:\Users\Ian\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"	"C:\Users\Ian\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"

当用户输入它们时如何解析它们？

我可以使用 IFileOpenDialog 让用户 select 这些文件夹之一。但我真的希望用户能够 type

"C:\Users"
"C:\Windows\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")：失败

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

我如何将用户可能输入的各种特殊 shell 名称位置（Windows Explorer 和 IFileOpen 对话框可以解析）解析为该文件夹的 IShellItem ？

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

C:\Windows
回收站
这台电脑

稍后能够解析它们。

Answer 1

调试 Explorer 并看看它是如何工作的会很有趣。

我的建议是；如果初始解析失败，请将 shell: 添加到路径字符串并尝试使用 SHParseDisplayName 再次解析它。如果您在绑定上下文中设置 STR_PARSE_SHELL_PROTOCOL_TO_FILE_OBJECTS，您还可以绑定到特殊文件。 shell: 协议能够解析 special/known 文件夹的 internal/canonical 名称，但我不知道它是否也检查显示名称。

编辑：

我现在有机会尝试一下 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

On Windows 8 SHCreateItemFromParsingName 调用 SHParseDisplayName（使用 STR_PARSE_AND_CREATE_ITEM 和 STR_PARSE_TRANSLATE_ALIASES）因此即使是 Microsoft 也无法在其 API.

如果您想远离未记录的界面，那么您将不得不添加第三步检查已知文件夹显示名称。或者正如 Raymond Chen 在评论中所建议的那样；根据 IShellFolder.

中的项目显示名称手动解析每个路径组件

Answer 2

It would be interesting to debug Explorer and see how it does it.

从 windows 7 shell 使用下一个未记录的接口（直到它从 win 7 到最新的 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;

我们可以使用它来解析显示名称，如 Recycle Bin、This PC 等。（IFileOpenDialog 对话框使用它）

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

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

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

也可以使用异步解析 - 你需要调用 StartAsyncPathParse - 传递自己的 hwnd 和可选的 ICancelMethodCalls 接口。当操作完成后 shell post RegisterWindowMessage(L"AC_ParseComplete") (wParam == IShellUrl*, lParam == 0) 到你的 window。您可以通过调用 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();
    }
}

Answer 3

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

如何将 SHCreateItemFromParsingName 与来自 shell 命名空间的名称一起使用？

How to use SHCreateItemFromParsingName with names from the shell namespace?

windows

winapi

windows-shell

不同的东西有不同的显示名称

当用户输入它们时如何解析它们？