ItemIDList结构（文件路径的转换）

最新推荐文章于 2025-04-16 16:15:28 发布

转载最新推荐文章于 2025-04-16 16:15:28 发布 · 1.3k 阅读

Windows编程专栏收录该内容

13 篇文章

订阅专栏

本文介绍如何将文件路径转换为ItemIDList，以便在Windows应用程序中作为文件夹浏览窗口的根目录。通过使用SHGetDesktopFolder和ParseDisplayName等API，可以实现自定义浏览窗口的初始显示位置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

文章转载自网络

将文件路径转换至ItemIDList

通常我们会用SHBrowseForFolder接口来打开一个文件夹浏览窗口，代码一般如下：

BROWSEINFO bi = { 0 };
LPITEMIDLIST pItemIDList = SHBrowseForFolder( &bi );

这样就会打开一个浏览文件夹窗口，如下：

SHBrowseForFolder接口传入的参数为BROWSEINFO结构体指针，该结构体指针中有个ItemIDList指针成员pidlRoot，即为打开浏览文件夹窗口后显示的根目录，如果该形参为NULL，那么桌面将为根目录。

现在，我们打算将根目录置为任何我想显示的文件路径，该怎么做呢？那么我们就要将文件路径转换到对应的ItemIDList，然后赋值给pidlRoot。

首先我们要得到桌面的目录，代码如下：

LPSHELLFOLDER pDesktopFolder = NULL;
HRESULT hr = SHGetDesktopFolder( &pDesktopFolder );
if ( FAILED(hr) )
{
return NULL;
}

然后通过调用ParseDisplayName接口就可以得到文件路径对应的ItemIDList了，由于ParseDisplayName的形参类型为LPOLESTR，所以我们需要先转化，代码如下：

OLECHAR strOleFilePath[MAX_PATH];
MultiByteToWideChar( CP_ACP, MB_PRECOMPOSED, strFilePath.c_str(), -1, strOleFilePath, MAX_PATH );

然后，我们就可以调用ParseDisplayName去得到文件路径对应的ItemIDList了，代码如下：

LPITEMIDLIST pItemIDList = NULL;
hr = pDesktopFolder->ParseDisplayName( NULL, NULL, strOleFilePath, NULL, &pItemIDList, NULL );
pDesktopFolder->Release();
if ( FAILED(hr) )
{
return NULL;
}

这样我们就得到了文件路径对应的ItemIDList，然后就可以以它为根目录显示了，代码如下：

BROWSEINFO bi = { 0 };
bi.pidlRoot = GetItemIDListFromFilePath( "F:\\NewtonSDK" ); // 返回NULL也没关系，以桌面为根

LPITEMIDLIST pItemIDList = SHBrowseForFolder( &bi );

好了，至此我们的任务就完成了，以上仅供大家参考，谢谢^-^！

附上完整代码：

LPITEMIDLIST GetItemIDListFromFilePath( const std::string &strFilePath )
{
if ( strFilePath.empty() )
{
return NULL;
}

// 得到桌面的目录
LPSHELLFOLDER pDesktopFolder = NULL;
HRESULT hr = SHGetDesktopFolder( &pDesktopFolder );
if ( FAILED(hr) )
{
return NULL;
}

// 将文件路径转换至OLECHAR格式
OLECHAR strOleFilePath[MAX_PATH];
MultiByteToWideChar( CP_ACP, MB_PRECOMPOSED, strFilePath.c_str(), -1, strOleFilePath, MAX_PATH );

// 得到文件路径对应的ItemIDList
LPITEMIDLIST pItemIDList = NULL;
hr = pDesktopFolder->ParseDisplayName( NULL, NULL, strOleFilePath, NULL, &pItemIDList, NULL );
pDesktopFolder->Release();
if ( FAILED(hr) )
{
return NULL;
}

return pItemIDList;
}