{"id":1503,"date":"2014-03-14T07:00:00","date_gmt":"2014-03-14T07:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2014\/03\/14\/how-do-i-create-an-ishellitemarray-from-a-bunch-of-file-paths\/"},"modified":"2014-03-14T07:00:00","modified_gmt":"2014-03-14T07:00:00","slug":"how-do-i-create-an-ishellitemarray-from-a-bunch-of-file-paths","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20140314-00\/?p=1503","title":{"rendered":"How do I create an IShellItemArray from a bunch of file paths?"},"content":{"rendered":"

\nThe IFile­Operation<\/code> interface accepts bulk operations\nin the form of an IShell­Item­Array<\/code>.\nSo how do you take a list of file names and convert them\ninto an\nIShell­Item­Array<\/code>?\n<\/p>\n

\nThere is no\nSHCreate­Shell­Item­Array­From­Paths<\/code>\nfunction, but there is a\nSHCreate­Shell­Item­Array­From­ID­Lists<\/code>,\nand we know how to convert a path to an ID list,\nnamely via\nSHParse­Display­Name<\/code>.\nSo lets\n\nsnap two blocks together<\/a>.\n<\/p>\n

\n#define UNICODE\n#define _UNICODE<\/a>\n#define STRICT\n#define STRICT_TYPED_ITEMIDS<\/a>\n#include <windows.h>\n#include <shlobj.h>\n#include <wrl\/client.h>\n\/\/ class CCoInitialize incorporated by reference<\/a>\ntemplate<typename T>\nHRESULT CreateShellItemArrayFromPaths(\n    UINT ct, T rgt[], IShellItemArray **ppsia)\n{\n *ppsia = nullptr;\n PIDLIST_ABSOLUTE *rgpidl = new(std::nothrow) PIDLIST_ABSOLUTE[ct];\n HRESULT hr = rgpidl ? S_OK : E_OUTOFMEMORY;\n int cpidl;\n for (cpidl = 0; SUCCEEDED(hr) && cpidl < ct; cpidl++)\n {\n  hr = SHParseDisplayName(rgt[cpidl], nullptr, &rgpidl[cpidl], 0, nullptr);\n }\n if (SUCCEEDED(hr)) {\n  hr = SHCreateShellItemArrayFromIDLists(cpidl, rgpidl, ppsia);\n }\n for (int i = 0; i < cpidl; i++)\n {\n  CoTaskMemFree(rgpidl[i]);\n }\n delete[] rgpidl;\n return hr;\n}\n<\/pre>\n
\nThe\nCreate­Shell­Item­Array­From­Paths<\/code>\ntemplate function takes an array of paths and starts by creating\na corresponding array of ID lists.\n(If you’re feeling fancy, you can\n\nuse a file system bind context to make simple ID lists<\/a>.)\nIt then pumps this array into the\nSHCreate­Shell­Item­Array­From­ID­Lists<\/code>\nfunction to get the item array.\n<\/p>\n
\nUsing a template allows you to pass an array of anything<\/i>\nas the array of paths, as long as it has a conversion to\nPCWSTR<\/code>.\nSo you can pass\nan array of PCWSTR<\/code> or\nan array of PWSTR<\/code> or\nan array of BSTR<\/code> or\nan array of CCom­Heap­Ptr<wchar_t><\/code> or\nan array of CStringW<\/code>\nor whatever else floats your boat.\n<\/p>\n
\nLet’s take this function out for a spin.\n<\/p>\n
\nint __cdecl wmain(int argc, wchar_t **argv)\n{\n CCoInitialize init;\n Microsoft::WRL::ComPtr<IShellItemArray> spsia;\n Microsoft::WRL::ComPtr<IFileOperation> spfo;\n if (SUCCEEDED(CreateShellItemArrayFromPaths(\n                      argc - 1, argv + 1, &spsia)) &&\n     SUCCEEDED(CoCreateInstance(__uuidof(FileOperation), nullptr,\n                      CLSCTX_ALL, IID_PPV_ARGS(&spfo)))) {\n  spfo->DeleteItems(spsia.Get());\n  spfo->PerformOperations();\n }\n return 0;\n}\n<\/pre>\n
\nThe main program first treats the command line arguments\nas a list of absolute file paths\nand uses our new helper function to create a shell item array\nfrom them.\nIt then passes the shell item array to the\nIFile­Operation::Delete­Items<\/code> method\nto delete all the items.\n<\/p>\n
\nNo magic here.\nJust taking the pieces available and combining them in a\nrelatively obvious way.<\/p>\n","protected":false},"excerpt":{"rendered":"
The IFile­Operation interface accepts bulk operations in the form of an IShell­Item­Array. So how do you take a list of file names and convert them into an IShell­Item­Array? There is no SHCreate­Shell­Item­Array­From­Paths function, but there is a SHCreate­Shell­Item­Array­From­ID­Lists, and we know how to convert a path to an ID list, namely via SHParse­Display­Name. So lets […]<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-1503","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
The IFile­Operation interface accepts bulk operations in the form of an IShell­Item­Array. So how do you take a list of file names and convert them into an IShell­Item­Array? There is no SHCreate­Shell­Item­Array­From­Paths function, but there is a SHCreate­Shell­Item­Array­From­ID­Lists, and we know how to convert a path to an ID list, namely via SHParse­Display­Name. So lets […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/1503","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=1503"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/1503\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=1503"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=1503"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=1503"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}