\nFor some reason, a lot of people are interested in programmatic\naccess to the contents of the Recycle Bin.\nThey never explain why they care,\nso it’s possible that they are looking at their problem the wrong way.\n<\/p>\n
\nFor example, one reason for asking,\n“How do I purge an item from the Recycle Bin given a path?”\nis that\nsome operation in their program results in the files going\ninto the Recycle Bin and they want them to be deleted entirely.\nThe correct solution is to clear the \nThe Recycle Bin is somewhat strange in that it can have multiple items\nwith the same name.\nCreate a text file called \nNow look at that original problem:\nSuppose the program, as part of some operation, moves\nthe file \nOkay, I got kind of sidetracked there.\nBack to the issue of getting information about the items in the\nRecycle Bin.\n<\/p>\n \nThe Recycle Bin is a shell folder,\nand the way to enumerate the contents of a shell folder is to\nbind to it and enumerate its contents.\nThe low-level interface to the shell namespace is via\n \nI’ll start with the low-level interface.\nAs usual, the program starts with a bunch of header files.\n<\/p>\n \nThe \nThe subtlety here is in the test for \nAnother helper function prints the display name of a shell namespace item.\nThere isn’t much interesting here either.\n<\/p>\n \nOur last helper function retrieves a property from the shell namespace\nand prints it.\n(Obviously, if we wanted to do something other than print it,\nwe could coerce the type to something other than \nOkay, now we can get down to business.\nThe properties we will display from each item in the Recycle Bin\nare the item name and path,\nthe original location (before the item was deleted),\nthe date the item was deleted,\nand the size of the item.\n<\/p>\n \nGetting the name and path are done with\nvarious combinations of flags to\n \nThe other property we want is\n\n \nOkay, let’s roll!\n<\/p>\nFOF_ALLOWUNDO<\/code> flag\nwhen deleting the items in the first place.\nMoving to the Recycle Bin and then purging is the wrong solution because\nyour search-and-destroy mission may purge more items than just the\nones your program put there.\n<\/p>\nTEST.TXT<\/code> on your desktop,\nthen delete it into the Recycle Bin.\nCreate another text file called TEST.TXT<\/code> on your desktop,\nthen delete it into the Recycle Bin.\nNow open your Recycle Bin.\nHey look, you have two TEST.TXT<\/code> files with the same path!\n<\/p>\nTEST.TXT<\/code> from the desktop to the Recycle Bin,\nand then the second half of the program goes into the Recycle Bin,\nfinds TEST.TXT<\/code> and purges it.\nWell, there are actually three copies of TEST.TXT<\/code> in the\nRecycle Bin, and only one of them is the one you wanted to purge.\n<\/p>\nIShellFolder<\/code>.\nThere is an easier-to-use medium-level interface based on\nIShellItem<\/code>,\nand there’s a high-level interface based on Folder<\/code>\ndesigned for scripting.\n<\/p>\n\n#include <windows.h>\n#include <stdio.h>\n#include <tchar.h>\n#include <shlobj.h>\n#include <shlwapi.h>\n#include <propkey.h>\n<\/pre>\n
BindToCsidl<\/code> function binds to a folder specified\nby a CSIDL<\/code>.\nThe modern way to do this is via KNOWNFOLDER<\/code>,\nbut just to keep you old fogeys happy, I’m doing things the\nclassic way since you refuse to upgrade from Windows XP.\n(We’ll look at the modern way later.)\n<\/p>\n\nHRESULT BindToCsidl(int csidl, REFIID riid, void **ppv)\n{\n HRESULT hr;\n PIDLIST_ABSOLUTE pidl;\n hr = SHGetSpecialFolderLocation(NULL, csidl, &pidl);\n if (SUCCEEDED(hr)) {\n IShellFolder *psfDesktop;\n hr = SHGetDesktopFolder(&psfDesktop);\n if (SUCCEEDED(hr)) {\n if (pidl->mkid.cb) {\n hr = psfDesktop->BindToObject(pidl, NULL, riid, ppv);\n } else {\n hr = psfDesktop->QueryInterface(riid, ppv);\n }\n psfDesktop->Release();\n }\n CoTaskMemFree(pidl);\n }\n return hr;\n}\n<\/pre>\npidl->mkid.cb<\/code>.\nThe IShellFolder::BindToObject<\/code>\nmethod is for binding\nto child objects (or grandchildren or deeper descendants).\nIf the object you want is the desktop itself, then you can’t use\nIShellFolder::BindToObject<\/code>\nsince the desktop is not\na child of itself.\nIn fact, if the object you want is the desktop itself,\nthen you already have the desktop<\/i>,\nso we just QueryInterface<\/code> for it.\nIt’s an annoying special case which usually lurks in your code\nuntil somebody tries something like “Save file to desktop”\nor changes the location of a special folder to the desktop,\nand then\nboom you trip over the fact that the desktop is not a child of itself.\n(See further discussion below.)\n<\/p>\n\nvoid PrintDisplayName(IShellFolder *psf,\n PCUITEMID_CHILD pidl, SHGDNF uFlags, PCTSTR pszLabel)\n{\n STRRET<\/a> sr;\n HRESULT hr = psf->GetDisplayNameOf(pidl, uFlags, &sr);\n if (SUCCEEDED(hr)) {\n PTSTR pszName;\n hr = StrRetToStr(&sr, pidl, &pszName);\n if (SUCCEEDED(hr)) {\n _tprintf(TEXT(\"%s = %s\\n\"), pszLabel, pszName);\n CoTaskMemFree(pszName);\n }\n }\n}\n<\/pre>\nVT_BSTR<\/code>.)\n<\/p>\n\nvoid PrintDetail(IShellFolder2 *psf, PCUITEMID_CHILD pidl,\n const SHCOLUMNID *pscid, PCTSTR pszLabel)\n{\n VARIANT vt;\n HRESULT hr = psf->GetDetailsEx(pidl, pscid, &vt);\n if (SUCCEEDED(hr)) {\n hr = VariantChangeType(&vt, &vt, 0, VT_BSTR);\n if (SUCCEEDED(hr)) {\n _tprintf(TEXT(\"%s: %ws\\n\"), pszLabel, V_BSTR(&vt));\n }\n VariantClear(&vt);\n }\n}\n<\/pre>\nIShellFolder::GetDisplayNameOf<\/code>,\nwhereas getting the other properties involve talking to the\nshell property system.\n(My colleague\n\nBen Karas<\/a>\ncovers the\n\nshell property system<\/a> on his blog.)\nThe\n\nSHCOLUMNID<\/code> documentation<\/a>\nsays that the displaced property set applies to items which have been\nmoved to the Recycle Bin,\nso we can define those column IDs based on the values provided in\nshlguid.h<\/code>:<\/p>\n\nconst SHCOLUMNID SCID_OriginalLocation =\n { PSGUID_DISPLACED<\/a>, PID_DISPLACED_FROM };\nconst SHCOLUMNID SCID_DateDeleted =\n { PSGUID_DISPLACED, PID_DISPLACED_DATE };\n<\/pre>\nSystem.Size<\/code><\/a>,\nwhich the documentation says is defined as\nPKEY_Size<\/code> by the\npropkey.h<\/code> header file.\n<\/p>\n\nint __cdecl _tmain(int argc, PTSTR *argv)\n{\n HRESULT hr = CoInitialize(NULL);\n if (SUCCEEDED(hr)) {\n IShellFolder2 *psfRecycleBin;\n hr = BindToCsidl(CSIDL_BITBUCKET, IID_PPV_ARGS(&psfRecycleBin));\n if (SUCCEEDED(hr)) {\n IEnumIDList *peidl;\n hr = psfRecycleBin->EnumObjects(NULL,\n SHCONTF_FOLDERS | SHCONTF_NONFOLDERS<\/a>, &peidl);\n if (hr == S_OK<\/font>) {\n PITEMID_CHILD pidlItem;\n while (peidl->Next(1, &pidlItem, NULL) == S_OK) {\n _tprintf(TEXT(\"------------------\\n\"));\n PrintDisplayName(psfRecycleBin, pidlItem,\n SHGDN_INFOLDER, TEXT(\"InFolder\"));\n PrintDisplayName(psfRecycleBin, pidlItem,\n SHGDN_NORMAL, TEXT(\"Normal\"));\n PrintDisplayName(psfRecycleBin, pidlItem,\n SHGDN_FORPARSING, TEXT(\"ForParsing\"));\n PrintDetail(psfRecycleBin, pidlItem,\n &SCID_OriginalLocation, TEXT(\"Original Location\"));\n PrintDetail(psfRecycleBin, pidlItem,\n &SCID_DateDeleted, TEXT(\"Date deleted\"));\n PrintDetail(psfRecycleBin, pidlItem,\n &PKEY_Size, TEXT(\"Size\"));\n CoTaskMemFree(pidlItem);\n }\n }\n psfRecycleBin->Release();\n }\n CoUninitialize();\n }\n return 0;\n}\n<\/pre>\n