Getting an ITEMIDLIST For a Path

If you have ever used ShBrowseForFolder(), you’ve probably noticed the pidlRoot member of the BROWSEINFO structure. It can be used to set the “root” folder to browse from. It’s usually set to NULL, which means the “Desktop” folder.

Ever wanted to use another folder as the root for the “Browse For Folder” common dialog, but didn’t know how to create an ITEMIDLIST for a given path? Here’s a function that does it.


BOOL GetItemIdListFromPath (LPWSTR lpszPath, LPITEMIDLIST *lpItemIdList)
{
   LPSHELLFOLDER pShellFolder = NULL;
   HRESULT         hr;
   ULONG         chUsed;

   // Get desktop IShellFolder interface
   if (SHGetDesktopFolder (&pShellFolder) != NOERROR)
      return FALSE;     // failed



   // convert the path to an ITEMIDLIST
   hr = pShellFolder->ParseDisplayName (
                  NULL,           // owner window
                  NULL,           // reserved (must be NULL)
                  lpszPath,       // folder name
                  &chUsed,    // number of chars parsed
                  lpItemIdList,   // ITEMIDLIST
                  NULL            // attributes (can be NULL)
               );

   if (FAILED(hr))
   {
      pShellFolder->Release();
      *lpItemIdList = NULL;
      return FALSE;
   }

   pShellFolder->Release();
   return TRUE;
} // GetItemIdListFromPath

It's written in C++, but converting it to plain C is just a matter of changing a couple of lines. To do it, change all interface calls like: pShellFolder->ParseDisplayName() to pShellFolder->lpVtbl->ParseDisplayName(pShellFolder, ...), and similar changes to other calls.

Two things: The function receives the path as a UNICODE (LPWSTR) string, so you'll have to convert ANSI strings to unicode using MultiByteToWideChar() before calling the function. Finally, remember that you should free the memory referenced by the pointer to the ITEMIDLIST you get from the function by calling the Free() method of the IMalloc interface, which you can get using SHGetMalloc().