shlfolder.cpp File Reference

#include "precomp.h"

Include dependency graph for shlfolder.cpp:

Go to the source code of this file.

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (shell)
SHCONTF	SHELL_GetDefaultFolderEnumSHCONTF ()
BOOL	SHELL_IncludeItemInFolderEnum (IShellFolder *pSF, PCUITEMID_CHILD pidl, SFGAOF Query, SHCONTF Flags)
static HRESULT	MapSCIDToShell32FsColumn (const SHCOLUMNID *pscid, VARTYPE &vt)
HRESULT	SHELL_MapSCIDToColumn (IShellFolder2 *pSF, const SHCOLUMNID *pscid)
template<class T >
static HRESULT	GetDetailsOfAsStringVariant (T &pSF, PCUITEMID_CHILD pidl, UINT Column, VARIANT *pVar)
HRESULT	SHELL_GetDetailsOfAsStringVariant (IShellFolder2 *pSF, PCUITEMID_CHILD pidl, UINT Column, VARIANT *pVar)
HRESULT	SHELL_GetDetailsOfAsStringVariant (IShellFolder *pSF, PCUITEMID_CHILD pidl, UINT Column, VARIANT *pVar)
HRESULT	SHELL_GetDetailsOfColumnAsVariant (IShellFolder2 *pSF, PCUITEMID_CHILD pidl, UINT Column, VARTYPE vt, VARIANT *pVar)
HRESULT	SH32_GetDetailsOfPKeyAsVariant (IShellFolder2 *pSF, PCUITEMID_CHILD pidl, const SHCOLUMNID *pscid, VARIANT *pVar, BOOL UseFsColMap)
HRESULT	SHELL_QueryInfoTipAlloc (_In_ IShellFolder *pSF, _In_ DWORD dwFlags, _In_ LPCITEMIDLIST pidl, _Out_ PWSTR *ppTip)
HRESULT	SHELL_CreateAbsolutePidl (IShellFolder *pSF, PCUIDLIST_RELATIVE pidlChild, PIDLIST_ABSOLUTE *ppPidl)
HRESULT	Shell_NextElement (_Inout_ LPWSTR *ppch, _Out_ LPWSTR pszOut, _In_ INT cchOut, _In_ BOOL bValidate)
HRESULT	SHELL32_ParseNextElement (IShellFolder2 *psf, HWND hwndOwner, LPBC pbc, LPITEMIDLIST *pidlInOut, LPOLESTR szNext, DWORD *pEaten, DWORD *pdwAttributes)
HRESULT	SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, PERSIST_FOLDER_TARGET_INFO *ppfti, LPCITEMIDLIST pidlChild, const GUID *clsid, REFIID riid, LPVOID *ppvOut)
HRESULT	SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, const GUID *clsid, int csidl, REFIID riid, LPVOID *ppvOut)
HRESULT	SHELL32_BindToSF (LPCITEMIDLIST pidlRoot, PERSIST_FOLDER_TARGET_INFO *ppfti, LPCITEMIDLIST pidl, const GUID *clsid, REFIID riid, LPVOID *ppvOut)
HRESULT	SHELL32_GetDisplayNameOfChild (IShellFolder2 *psf, LPCITEMIDLIST pidl, DWORD dwFlags, LPSTRRET strRet)
HRESULT	SHELL32_CompareChildren (IShellFolder2 *psf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
HRESULT	SHELL32_CompareDetails (IShellFolder2 *isf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
void	CloseRegKeyArray (HKEY *array, UINT cKeys)
LSTATUS	AddClassKeyToArray (const WCHAR *szClass, HKEY *array, UINT *cKeys)
LSTATUS	AddClsidKeyToArray (REFCLSID clsid, HKEY *array, UINT *cKeys)
void	AddFSClassKeysToArray (UINT cidl, PCUITEMID_CHILD_ARRAY apidl, HKEY *array, UINT *cKeys)
void	AddPidlClassKeysToArray (LPCITEMIDLIST pidl, HKEY *array, UINT *cKeys)
HRESULT	SH_GetApidlFromDataObject (IDataObject *pDataObject, PIDLIST_ABSOLUTE *ppidlfolder, PUITEMID_CHILD **apidlItems, UINT *pcidl)
HRESULT WINAPI	SHCreateLinks (HWND hWnd, LPCSTR lpszDir, IDataObject *lpDataObject, UINT uFlags, LPITEMIDLIST *lppidlLinks)
EXTERN_C HRESULT WINAPI	SHOpenFolderAndSelectItems (PCIDLIST_ABSOLUTE pidlFolder, UINT cidl, PCUITEMID_CHILD_ARRAY apidl, DWORD dwFlags)
HRESULT	SHELL32_ShowPropertiesDialog (IDataObject *pdtobj)
HRESULT	SHELL32_DefaultContextMenuCallBack (IShellFolder *psf, IDataObject *pdo, UINT msg)

Function Documentation

AddClassKeyToArray()

LSTATUS AddClassKeyToArray	(	const WCHAR *	szClass,
		HKEY *	array,
		UINT *	cKeys
	)

Definition at line 440 of file shlfolder.cpp.

{
    if (*cKeys >= 16)
        return ERROR_MORE_DATA;
 
    HKEY hkey;
    LSTATUS result = RegOpenKeyExW(HKEY_CLASSES_ROOT, szClass, 0, KEY_READ | KEY_QUERY_VALUE, &hkey);
    if (result == ERROR_SUCCESS)
    {
        array[*cKeys] = hkey;
        *cKeys += 1;
    }
    return result;
}

Referenced by AddClsidKeyToArray(), and AddFSClassKeysToArray().

AddClsidKeyToArray()

LSTATUS AddClsidKeyToArray	(	REFCLSID	clsid,
		HKEY *	array,
		UINT *	cKeys
	)

Definition at line 455 of file shlfolder.cpp.

{
    WCHAR path[6 + 38 + 1] = L"CLSID\\";
    StringFromGUID2(clsid, path + 6, 38 + 1);
    return AddClassKeyToArray(path, array, cKeys);
}

Referenced by CRegItemContextMenu_CreateInstance(), and CDesktopFolder::GetUIObjectOf().

AddFSClassKeysToArray()

void AddFSClassKeysToArray	(	UINT	cidl,
		PCUITEMID_CHILD_ARRAY	apidl,
		HKEY *	array,
		UINT *	cKeys
	)

Definition at line 462 of file shlfolder.cpp.

{
    // This function opens the association array keys in canonical order for filesystem items.
    // The order is documented: learn.microsoft.com/en-us/windows/win32/shell/fa-associationarray
 
    ASSERT(cidl >= 1 && apidl);
    PCUITEMID_CHILD pidl = apidl[0];
    if (_ILIsValue(pidl))
    {
        WCHAR buf[MAX_PATH];
        PWSTR name;
        FileStructW* pFileData = _ILGetFileStructW(pidl);
        if (pFileData)
        {
            name = pFileData->wszName;
        }
        else
        {
            _ILSimpleGetTextW(pidl, buf, _countof(buf));
            name = buf;
        }
        LPCWSTR extension = PathFindExtension(name);
 
        if (extension)
        {
            WCHAR wszClass[MAX_PATH], wszSFA[23 + _countof(wszClass)];
            DWORD dwSize = sizeof(wszClass);
            if (RegGetValueW(HKEY_CLASSES_ROOT, extension, NULL, RRF_RT_REG_SZ, NULL, wszClass, &dwSize) != ERROR_SUCCESS ||
                !*wszClass || AddClassKeyToArray(wszClass, array, cKeys) != ERROR_SUCCESS)
            {
                // Only add the extension key if the ProgId is not valid
                AddClassKeyToArray(extension, array, cKeys);
 
                // "Open With" becomes the default when there are no verbs in the above keys
                if (cidl == 1)
                    AddClassKeyToArray(L"Unknown", array, cKeys);
            }
 
            _swprintf(wszSFA, L"SystemFileAssociations\\%s", extension);
            AddClassKeyToArray(wszSFA, array, cKeys);
 
            dwSize = sizeof(wszClass);
            if (RegGetValueW(HKEY_CLASSES_ROOT, extension, L"PerceivedType", RRF_RT_REG_SZ, NULL, wszClass, &dwSize) == ERROR_SUCCESS)
            {
                _swprintf(wszSFA, L"SystemFileAssociations\\%s", wszClass);
                AddClassKeyToArray(wszSFA, array, cKeys);
            }
        }
 
        AddClassKeyToArray(L"*", array, cKeys);
        AddClassKeyToArray(L"AllFilesystemObjects", array, cKeys);
    }
    else if (_ILIsFolder(pidl))
    {
        // FIXME: Directory > Folder > AFO is the correct order and it's
        // the order Windows reports in its undocumented association array
        // but it is somehow not the order Windows adds the items to its menu!
        // Until the correct algorithm in CDefaultContextMenu can be determined,
        // we add the folder keys in "menu order".
        AddClassKeyToArray(L"Folder", array, cKeys);
        AddClassKeyToArray(L"AllFilesystemObjects", array, cKeys);
        AddClassKeyToArray(L"Directory", array, cKeys);
    }
    else if (_ILIsDrive(pidl))
    {
        AddClassKeyToArray(L"Drive", array, cKeys);
        AddClassKeyToArray(L"Folder", array, cKeys);
    }
    else
    {
        ERR("Got non FS pidl\n");
    }
}

Referenced by AddPidlClassKeysToArray(), FSFolderItemPropDialogInitCallback(), CDesktopFolder::GetUIObjectOf(), and CFSFolder::GetUIObjectOf().

AddPidlClassKeysToArray()

void AddPidlClassKeysToArray	(	LPCITEMIDLIST	pidl,
		HKEY *	array,
		UINT *	cKeys
	)

Definition at line 536 of file shlfolder.cpp.

{
    if ((pidl = ILFindLastID(pidl)) != NULL)
        AddFSClassKeysToArray(1, &pidl, array, cKeys);
}

Referenced by CFSDropTarget::_GetEffectFromMenu().

CloseRegKeyArray()

void CloseRegKeyArray	(	HKEY *	array,
		UINT	cKeys
	)

Definition at line 434 of file shlfolder.cpp.

{
    for (UINT i = 0; i < cKeys; ++i)
        RegCloseKey(array[i]);
}

Referenced by CRegKeyHandleArray::~CRegKeyHandleArray().

GetDetailsOfAsStringVariant()

template<class T >

static HRESULT GetDetailsOfAsStringVariant ( T &  pSF, PCUITEMID_CHILD  pidl, UINT  Column, VARIANT *  pVar  )

inlinestatic

Definition at line 95 of file shlfolder.cpp.

{
    V_VT(pVar) = VT_EMPTY;
    SHELLDETAILS sd;
    sd.str.uType = STRRET_CSTR;
    HRESULT hr = pSF->GetDetailsOf(pidl, Column, &sd);
    if (FAILED(hr))
        return hr;
    if (FAILED(hr = StrRetToBSTR(&sd.str, pidl, &V_BSTR(pVar))))
        return hr;
    V_VT(pVar) = VT_BSTR;
    return hr;
}

Referenced by SHELL_GetDetailsOfAsStringVariant().

MapSCIDToShell32FsColumn()

static HRESULT MapSCIDToShell32FsColumn ( const SHCOLUMNID *  pscid, VARTYPE &  vt  )

static

Definition at line 58 of file shlfolder.cpp.

{
    if (pscid->fmtid == FMTID_Storage)
    {
        switch (pscid->pid)
        {
            case PID_STG_NAME:        vt = VT_BSTR; return SHFSF_COL_NAME;
            case PID_STG_SIZE:        vt = VT_UI8; return SHFSF_COL_SIZE;
            case PID_STG_STORAGETYPE: vt = VT_BSTR; return SHFSF_COL_TYPE;
            case PID_STG_ATTRIBUTES:  vt = VT_BSTR; return SHFSF_COL_FATTS;
            case PID_STG_WRITETIME:   vt = VT_DATE; return SHFSF_COL_MDATE;
        }
    }
    if (pscid->fmtid == FMTID_SummaryInformation && pscid->pid == PIDSI_COMMENTS)
    {
        vt = VT_BSTR;
        return SHFSF_COL_COMMENT;
    }
    return E_INVALIDARG;
}

Referenced by SH32_GetDetailsOfPKeyAsVariant().

SH32_GetDetailsOfPKeyAsVariant()

HRESULT SH32_GetDetailsOfPKeyAsVariant	(	IShellFolder2 *	pSF,
		PCUITEMID_CHILD	pidl,
		const SHCOLUMNID *	pscid,
		VARIANT *	pVar,
		BOOL	UseFsColMap
	)

Definition at line 152 of file shlfolder.cpp.

{
    // CFSFolder and CRegFolder uses the SHFSF_COL columns and can use the faster and better version,
    // everyone else must ask the folder to map the SCID to a column.
    VARTYPE vt = VT_EMPTY;
    HRESULT hr = UseFsColMap ? MapSCIDToShell32FsColumn(pscid, vt) : SHELL_MapSCIDToColumn(pSF, pscid);
    return SUCCEEDED(hr) ? SHELL_GetDetailsOfColumnAsVariant(pSF, pidl, hr, vt, pVar) : hr;
}

Referenced by CControlPanelFolder::GetDetailsEx(), CDrivesFolder::GetDetailsEx(), CFSFolder::GetDetailsEx(), and CRegFolder::GetDetailsEx().

SH_GetApidlFromDataObject()

HRESULT SH_GetApidlFromDataObject	(	IDataObject *	pDataObject,
		PIDLIST_ABSOLUTE *	ppidlfolder,
		PUITEMID_CHILD **	apidlItems,
		UINT *	pcidl
	)

Definition at line 542 of file shlfolder.cpp.

{
    CDataObjectHIDA cida(pDataObject);
 
    if (FAILED_UNEXPECTEDLY(cida.hr()))
        return cida.hr();
 
    /* convert the data into pidl */
    LPITEMIDLIST pidl;
    LPITEMIDLIST *apidl = _ILCopyCidaToaPidl(&pidl, cida);
    if (!apidl)
    {
        return E_OUTOFMEMORY;
    }
 
    *ppidlfolder = pidl;
    *apidlItems = apidl;
    *pcidl = cida->cidl;
 
    return S_OK;
}

Referenced by CFSDropTarget::_RepositionItems(), DrivesContextMenuCallback(), and RegFolderContextMenuCallback().

SHCreateLinks()

HRESULT WINAPI SHCreateLinks	(	HWND	hWnd,
		LPCSTR	lpszDir,
		IDataObject *	lpDataObject,
		UINT	uFlags,
		LPITEMIDLIST *	lppidlLinks
	)

Definition at line 569 of file shlfolder.cpp.

{
    FIXME("%p %s %p %08x %p\n", hWnd, lpszDir, lpDataObject, uFlags, lppidlLinks);
    return E_NOTIMPL;
}

SHELL32_BindToSF()

HRESULT SHELL32_BindToSF	(	LPCITEMIDLIST	pidlRoot,
		PERSIST_FOLDER_TARGET_INFO *	ppfti,
		LPCITEMIDLIST	pidl,
		const GUID *	clsid,
		REFIID	riid,
		LPVOID *	ppvOut
	)

Definition at line 325 of file shlfolder.cpp.

{
    PITEMID_CHILD pidlChild = ILCloneFirst (pidl);
    if (!pidlChild)
        return E_FAIL;
 
    CComPtr<IShellFolder> psf;
    HRESULT hr = SHELL32_CoCreateInitSF(pidlRoot,
                                        ppfti,
                                        pidlChild,
                                        clsid,
                                        IID_PPV_ARG(IShellFolder, &psf));
    ILFree(pidlChild);
 
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    if (_ILIsPidlSimple (pidl))
        return psf->QueryInterface(riid, ppvOut);
    else
        return psf->BindToObject(ILGetNext (pidl), NULL, riid, ppvOut);
}

Referenced by CDrivesFolder::BindToObject(), CFSFolder::BindToObject(), CNetFolder::BindToObject(), and CRegFolder::BindToObject().

SHELL32_CoCreateInitSF() [1/2]

HRESULT SHELL32_CoCreateInitSF	(	LPCITEMIDLIST	pidlRoot,
		const GUID *	clsid,
		int	csidl,
		REFIID	riid,
		LPVOID *	ppvOut
	)

Definition at line 314 of file shlfolder.cpp.

{
    /* fill the PERSIST_FOLDER_TARGET_INFO */
    PERSIST_FOLDER_TARGET_INFO pfti = {0};
    pfti.dwAttributes = -1;
    pfti.csidl = csidl;
 
    return SHELL32_CoCreateInitSF(pidlRoot, &pfti, NULL, clsid, riid, ppvOut);
}

SHELL32_CoCreateInitSF() [2/2]

HRESULT SHELL32_CoCreateInitSF	(	LPCITEMIDLIST	pidlRoot,
		PERSIST_FOLDER_TARGET_INFO *	ppfti,
		LPCITEMIDLIST	pidlChild,
		const GUID *	clsid,
		REFIID	riid,
		LPVOID *	ppvOut
	)

Definition at line 287 of file shlfolder.cpp.

{
    HRESULT hr;
    CComPtr<IShellFolder> pShellFolder;
 
    hr = SHCoCreateInstance(NULL, clsid, NULL, IID_PPV_ARG(IShellFolder, &pShellFolder));
    if (FAILED(hr))
        return hr;
 
    LPITEMIDLIST pidlAbsolute = ILCombine (pidlRoot, pidlChild);
    CComPtr<IPersistFolder> ppf;
    CComPtr<IPersistFolder3> ppf3;
 
    if (ppfti && SUCCEEDED(pShellFolder->QueryInterface(IID_PPV_ARG(IPersistFolder3, &ppf3))))
    {
        ppf3->InitializeEx(NULL, pidlAbsolute, ppfti);
    }
    else if (SUCCEEDED(pShellFolder->QueryInterface(IID_PPV_ARG(IPersistFolder, &ppf))))
    {
        ppf->Initialize(pidlAbsolute);
    }
    ILFree (pidlAbsolute);
 
    return pShellFolder->QueryInterface(riid, ppvOut);
}

Referenced by SHELL32_BindToSF(), and SHELL32_CoCreateInitSF().

SHELL32_CompareChildren()

HRESULT SHELL32_CompareChildren	(	IShellFolder2 *	psf,
		LPARAM	lParam,
		LPCITEMIDLIST	pidl1,
		LPCITEMIDLIST	pidl2
	)

Definition at line 381 of file shlfolder.cpp.

{
    PUIDLIST_RELATIVE nextpidl1 = ILGetNext (pidl1);
    PUIDLIST_RELATIVE nextpidl2 = ILGetNext (pidl2);
 
    bool isEmpty1 = _ILIsDesktop(nextpidl1);
    bool isEmpty2 = _ILIsDesktop(nextpidl2);
    if (isEmpty1 || isEmpty2)
        return MAKE_COMPARE_HRESULT(isEmpty2 - isEmpty1);
 
    PITEMID_CHILD firstpidl = ILCloneFirst (pidl1);
    if (!firstpidl)
        return E_OUTOFMEMORY;
 
    CComPtr<IShellFolder> psf2;
    HRESULT hr = psf->BindToObject(firstpidl, 0, IID_PPV_ARG(IShellFolder, &psf2));
    ILFree(firstpidl);
    if (FAILED(hr))
        return MAKE_COMPARE_HRESULT(0);
 
    return psf2->CompareIDs(lParam, nextpidl1, nextpidl2);
}

Referenced by CDrivesFolder::CompareIDs(), CFSFolder::CompareIDs(), CRegFolder::CompareIDs(), and SHELL32_CompareDetails().

SHELL32_CompareDetails()

HRESULT SHELL32_CompareDetails	(	IShellFolder2 *	isf,
		LPARAM	lParam,
		LPCITEMIDLIST	pidl1,
		LPCITEMIDLIST	pidl2
	)

Definition at line 404 of file shlfolder.cpp.

{
    SHELLDETAILS sd;
    WCHAR wszItem1[MAX_PATH], wszItem2[MAX_PATH];
    HRESULT hres;
    UINT col = LOWORD(lParam); // Column index without SHCIDS_* flags
 
    hres = isf->GetDetailsOf(pidl1, col, &sd);
    if (FAILED(hres))
        return MAKE_COMPARE_HRESULT(1);
 
    hres = StrRetToBufW(&sd.str, pidl1, wszItem1, MAX_PATH);
    if (FAILED(hres))
        return MAKE_COMPARE_HRESULT(1);
 
    hres = isf->GetDetailsOf(pidl2, col, &sd);
    if (FAILED(hres))
        return MAKE_COMPARE_HRESULT(1);
 
    hres = StrRetToBufW(&sd.str, pidl2, wszItem2, MAX_PATH);
    if (FAILED(hres))
        return MAKE_COMPARE_HRESULT(1);
 
    int ret = CFSFolder::CompareUiStrings(wszItem1, wszItem2, lParam);
    if (ret == 0)
        return SHELL32_CompareChildren(isf, lParam, pidl1, pidl2);
 
    return MAKE_COMPARE_HRESULT(ret);
}

Referenced by CControlPanelFolder::CompareIDs(), CDrivesFolder::CompareIDs(), CFSFolder::CompareIDs(), CPrinterFolder::CompareIDs(), CRegFolder::CompareIDs(), and CRegFolder::CompareRegItemsSortOrder().

SHELL32_DefaultContextMenuCallBack()

HRESULT SHELL32_DefaultContextMenuCallBack	(	IShellFolder *	psf,
		IDataObject *	pdo,
		UINT	msg
	)

Definition at line 656 of file shlfolder.cpp.

{
    switch (msg)
    {
        case DFM_MERGECONTEXTMENU:
            return S_OK; // Yes, I want verbs
        case DFM_INVOKECOMMAND:
            return S_FALSE; // Do it for me please
        case DFM_GETDEFSTATICID:
            return S_FALSE; // Supposedly "required for Windows 7 to pick a default"
    }
    return E_NOTIMPL;
}

Referenced by CDesktopFolder::CallBack(), CDrivesFolder::CallBack(), CFSFolder::CallBack(), CNetFolderBackgroundMenuCB(), DrivesContextMenuCallback(), NetFolderMenuCallback(), and RegFolderContextMenuCallback().

SHELL32_GetDisplayNameOfChild()

HRESULT SHELL32_GetDisplayNameOfChild	(	IShellFolder2 *	psf,
		LPCITEMIDLIST	pidl,
		DWORD	dwFlags,
		LPSTRRET	strRet
	)

Definition at line 363 of file shlfolder.cpp.

{
    LPITEMIDLIST pidlFirst = ILCloneFirst(pidl);
    if (!pidlFirst)
        return E_OUTOFMEMORY;
 
    CComPtr<IShellFolder> psfChild;
    HRESULT hr = psf->BindToObject(pidlFirst, NULL, IID_PPV_ARG(IShellFolder, &psfChild));
    if (SUCCEEDED (hr))
    {
        hr = psfChild->GetDisplayNameOf(ILGetNext (pidl), dwFlags, strRet);
    }
    ILFree (pidlFirst);
 
    return hr;
}

Referenced by CDesktopFolder::GetDisplayNameOf(), CDrivesFolder::GetDisplayNameOf(), CFSFolder::GetDisplayNameOf(), and CRegFolder::GetDisplayNameOf().

SHELL32_ParseNextElement()

HRESULT SHELL32_ParseNextElement	(	IShellFolder2 *	psf,
		HWND	hwndOwner,
		LPBC	pbc,
		LPITEMIDLIST *	pidlInOut,
		LPOLESTR	szNext,
		DWORD *	pEaten,
		DWORD *	pdwAttributes
	)

Definition at line 236 of file shlfolder.cpp.

{
    HRESULT hr = E_INVALIDARG;
    LPITEMIDLIST pidlIn = pidlInOut ? *pidlInOut : NULL;
    LPITEMIDLIST pidlOut = NULL;
    LPITEMIDLIST pidlTemp = NULL;
    CComPtr<IShellFolder> psfChild;
 
    TRACE ("(%p, %p, %p, %s)\n", psf, pbc, pidlIn, debugstr_w (szNext));
 
    /* get the shellfolder for the child pidl and let it analyse further */
    hr = psf->BindToObject(pidlIn, pbc, IID_PPV_ARG(IShellFolder, &psfChild));
    if (FAILED(hr))
        return hr;
 
    hr = psfChild->ParseDisplayName(hwndOwner, pbc, szNext, pEaten, &pidlOut, pdwAttributes);
    if (FAILED(hr))
        return hr;
 
    pidlTemp = ILCombine (pidlIn, pidlOut);
    if (!pidlTemp)
    {
        hr = E_OUTOFMEMORY;
        if (pidlOut)
            ILFree(pidlOut);
        return hr;
    }
 
    if (pidlOut)
        ILFree (pidlOut);
 
    if (pidlIn)
        ILFree (pidlIn);
 
    *pidlInOut = pidlTemp;
 
    TRACE ("-- pidl=%p ret=0x%08x\n", pidlInOut ? *pidlInOut : NULL, hr);
    return S_OK;
}

Referenced by CRegFolder::ParseDisplayName().

SHELL32_ShowPropertiesDialog()

HRESULT SHELL32_ShowPropertiesDialog

(

IDataObject *

pdtobj

)

Definition at line 648 of file shlfolder.cpp.

{
    if (!pdtobj)
        return E_INVALIDARG;
    return SHELL32_ShowFilesystemItemsPropertiesDialogAsync(NULL, pdtobj);
}

Referenced by CDesktopFolder::CallBack(), and CDefaultContextMenu::DoProperties().

SHELL_CreateAbsolutePidl()

HRESULT SHELL_CreateAbsolutePidl	(	IShellFolder *	pSF,
		PCUIDLIST_RELATIVE	pidlChild,
		PIDLIST_ABSOLUTE *	ppPidl
	)

Definition at line 174 of file shlfolder.cpp.

{
    PIDLIST_ABSOLUTE pidlFolder;
    HRESULT hr = SHGetIDListFromObject(pSF, &pidlFolder);
    if (SUCCEEDED(hr))
    {
        hr = SHILCombine(pidlFolder, pidlChild, ppPidl);
        ILFree(pidlFolder);
    }
    return hr;
}

Referenced by CRegFolder::SetNameOf().

SHELL_GetDefaultFolderEnumSHCONTF()

SHCONTF SHELL_GetDefaultFolderEnumSHCONTF

(

)

Definition at line 29 of file shlfolder.cpp.

{
    SHCONTF Flags = SHCONTF_FOLDERS | SHCONTF_NONFOLDERS;
    SHELLSTATE ss;
    SHGetSetSettings(&ss, SSF_SHOWALLOBJECTS | SSF_SHOWSUPERHIDDEN, FALSE);
    if (ss.fShowAllObjects)
        Flags |= SHCONTF_INCLUDEHIDDEN;
    if (ss.fShowSuperHidden)
        Flags |= SHCONTF_INCLUDESUPERHIDDEN;
     return Flags;
}

Referenced by SHELL32_GetFSItemAttributes().

SHELL_GetDetailsOfAsStringVariant() [1/2]

HRESULT SHELL_GetDetailsOfAsStringVariant	(	IShellFolder *	pSF,
		PCUITEMID_CHILD	pidl,
		UINT	Column,
		VARIANT *	pVar
	)

Definition at line 116 of file shlfolder.cpp.

{
    HRESULT hr;
    CComPtr<IShellFolder2> pSF2;
    if (SUCCEEDED(hr = pSF->QueryInterface(IID_PPV_ARG(IShellFolder2, &pSF2))))
        return SHELL_GetDetailsOfAsStringVariant(pSF2, pidl, Column, pVar);
    CComPtr<IShellDetails> pSD;
    if (SUCCEEDED(hr = pSF->CreateViewObject(NULL, IID_PPV_ARG(IShellDetails, &pSD))))
        return GetDetailsOfAsStringVariant(pSD, pidl, Column, pVar);
    return hr;
}

Referenced by CFSFolder::GetDetailsEx(), and CFolder::GetDetailsOf().

SHELL_GetDetailsOfAsStringVariant() [2/2]

HRESULT SHELL_GetDetailsOfAsStringVariant	(	IShellFolder2 *	pSF,
		PCUITEMID_CHILD	pidl,
		UINT	Column,
		VARIANT *	pVar
	)

Definition at line 110 of file shlfolder.cpp.

{
    return GetDetailsOfAsStringVariant(pSF, pidl, Column, pVar);
}

Referenced by SHELL_GetDetailsOfAsStringVariant(), and SHELL_GetDetailsOfColumnAsVariant().

SHELL_GetDetailsOfColumnAsVariant()

HRESULT SHELL_GetDetailsOfColumnAsVariant	(	IShellFolder2 *	pSF,
		PCUITEMID_CHILD	pidl,
		UINT	Column,
		VARTYPE	vt,
		VARIANT *	pVar
	)

Definition at line 129 of file shlfolder.cpp.

{
    HRESULT hr = SHELL_GetDetailsOfAsStringVariant(pSF, pidl, Column, pVar);
    if (FAILED(hr))
        return hr;
    if (vt == VT_EMPTY)
    {
        SHCOLSTATEF state;
        if (FAILED(pSF->GetDefaultColumnState(Column, &state)))
            state = SHCOLSTATE_TYPE_STR;
        if ((state & SHCOLSTATE_TYPEMASK) == SHCOLSTATE_TYPE_INT)
            vt = VT_I8;
        else if ((state & SHCOLSTATE_TYPEMASK) == SHCOLSTATE_TYPE_DATE)
            vt = VT_DATE;
        else
            vt = VT_BSTR;
    }
    if (vt != VT_BSTR)
        VariantChangeType(pVar, pVar, 0, vt);
    return hr;
}

Referenced by SH32_GetDetailsOfPKeyAsVariant().

SHELL_IncludeItemInFolderEnum()

BOOL SHELL_IncludeItemInFolderEnum	(	IShellFolder *	pSF,
		PCUITEMID_CHILD	pidl,
		SFGAOF	Query,
		SHCONTF	Flags
	)

Definition at line 41 of file shlfolder.cpp.

{
    if (SUCCEEDED(pSF->GetAttributesOf(1, &pidl, &Query)))
    {
        if (Query & SFGAO_NONENUMERATED)
            return FALSE;
        if ((Query & SFGAO_HIDDEN) && !(Flags & SHCONTF_INCLUDEHIDDEN))
            return FALSE;
        if ((Query & (SFGAO_HIDDEN | SFGAO_SYSTEM)) == (SFGAO_HIDDEN | SFGAO_SYSTEM) && !(Flags & SHCONTF_INCLUDESUPERHIDDEN))
            return FALSE;
        if ((Flags & (SHCONTF_FOLDERS | SHCONTF_NONFOLDERS)) != (SHCONTF_FOLDERS | SHCONTF_NONFOLDERS))
            return (Flags & SHCONTF_FOLDERS) ? (Query & SFGAO_FOLDER) : !(Query & SFGAO_FOLDER);
    }
    return TRUE;
}

Referenced by CRegFolderEnum::AddItemsFromKey(), and CRegFolderEnum::Initialize().

SHELL_MapSCIDToColumn()

HRESULT SHELL_MapSCIDToColumn	(	IShellFolder2 *	pSF,
		const SHCOLUMNID *	pscid
	)

Definition at line 80 of file shlfolder.cpp.

{
    for (UINT i = 0; i <= SHCIDS_COLUMNMASK; ++i)
    {
        SHCOLUMNID scid;
        HRESULT hr = pSF->MapColumnToSCID(i, &scid);
        if (FAILED(hr))
            break;
        if (IsEqualPropertyKey(scid, *pscid))
            return i;
    }
    return E_FAIL;
}

Referenced by SH32_GetDetailsOfPKeyAsVariant().

Shell_NextElement()

HRESULT Shell_NextElement	(	_Inout_ LPWSTR *	ppch,
		_Out_ LPWSTR	pszOut,
		_In_ INT	cchOut,
		_In_ BOOL	bValidate
	)

Definition at line 187 of file shlfolder.cpp.

{
    *pszOut = UNICODE_NULL;
 
    if (!*ppch)
        return S_FALSE;
 
    HRESULT hr;
    LPWSTR pchNext = wcschr(*ppch, L'\\');
    if (pchNext)
    {
        if (*ppch < pchNext)
        {
            /* Get an element */
            StringCchCopyNW(pszOut, cchOut, *ppch, pchNext - *ppch);
            ++pchNext;
 
            if (!*pchNext)
                pchNext = NULL; /* No next */
 
            hr = S_OK;
        }
        else /* Double backslashes found? */
        {
            pchNext = NULL;
            hr = E_INVALIDARG;
        }
    }
    else /* No more next */
    {
        StringCchCopyW(pszOut, cchOut, *ppch);
        hr = S_OK;
    }
 
    *ppch = pchNext; /* Go next */
 
    if (hr == S_OK && bValidate && !PathIsValidElement(pszOut))
    {
        *pszOut = UNICODE_NULL;
        hr = E_INVALIDARG;
    }
 
    return hr;
}

Referenced by CFSFolder::_ParseSimple(), and CFSFolder::ParseDisplayName().

SHELL_QueryInfoTipAlloc()

HRESULT SHELL_QueryInfoTipAlloc	(	_In_ IShellFolder *	pSF,
		_In_ DWORD	dwFlags,
		_In_ LPCITEMIDLIST	pidl,
		_Out_ PWSTR *	ppTip
	)

Definition at line 162 of file shlfolder.cpp.

{
    if (!pidl)
        return E_INVALIDARG;
    CComPtr<IQueryInfo> pQI;
    HRESULT hr = pSF->GetUIObjectOf(NULL, 1, &pidl, IID_NULL_PPV_ARG(IQueryInfo, &pQI));
    if (FAILED(hr))
        return hr;
    hr = pQI->GetInfoTip(dwFlags, ppTip); // Note: *ppTip can be NULL if there is no tip
    return SUCCEEDED(hr) && !*ppTip ? S_FALSE : hr;
}

Referenced by CFolder::GetDetailsOf().

SHOpenFolderAndSelectItems()

EXTERN_C HRESULT WINAPI SHOpenFolderAndSelectItems	(	PCIDLIST_ABSOLUTE	pidlFolder,
		UINT	cidl,
		PCUITEMID_CHILD_ARRAY	apidl,
		DWORD	dwFlags
	)

Definition at line 583 of file shlfolder.cpp.

{
    ERR("SHOpenFolderAndSelectItems() is hackplemented\n");
    CComHeapPtr<ITEMIDLIST> freeItem;
    PCIDLIST_ABSOLUTE pidlItem;
    if (cidl)
    {
        /* Firefox sends a full pidl here dispite the fact it is a PCUITEMID_CHILD_ARRAY -_- */
        if (!ILIsSingle(apidl[0]))
        {
            pidlItem = apidl[0];
        }
        else
        {
            HRESULT hr = SHILCombine(pidlFolder, apidl[0], &pidlItem);
            if (FAILED_UNEXPECTEDLY(hr))
                return hr;
            freeItem.Attach(const_cast<PIDLIST_ABSOLUTE>(pidlItem));
        }
    }
    else
    {
        pidlItem = pidlFolder;
    }
 
    CComPtr<IShellFolder> psfDesktop;
 
    HRESULT hr = SHGetDesktopFolder(&psfDesktop);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    STRRET strret;
    hr = psfDesktop->GetDisplayNameOf(pidlItem, SHGDN_FORPARSING, &strret);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    WCHAR wszBuf[MAX_PATH];
    hr = StrRetToBufW(&strret, pidlItem, wszBuf, _countof(wszBuf));
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    WCHAR wszParams[MAX_PATH];
    wcscpy(wszParams, L"/select,");
    wcscat(wszParams, wszBuf);
 
    SHELLEXECUTEINFOW sei;
    memset(&sei, 0, sizeof sei);
    sei.cbSize = sizeof sei;
    sei.fMask = SEE_MASK_WAITFORINPUTIDLE;
    sei.lpFile = L"explorer.exe";
    sei.lpParameters = wszParams;
 
    if (ShellExecuteExW(&sei))
        return S_OK;
    else
        return E_FAIL;
}

Referenced by CFindFolderContextMenu::InvokeCommand(), and CShellLink::OnCommand().

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

shell

)