CShellItem.cpp File Reference

#include "precomp.h"

Include dependency graph for CShellItem.cpp:

Go to the source code of this file.

Functions
	WINE_DEFAULT_DEBUG_CHANNEL (shell)
HRESULT WINAPI	SHCreateShellItem (PCIDLIST_ABSOLUTE pidlParent, IShellFolder *psfParent, PCUITEMID_CHILD pidl, IShellItem **ppsi)
EXTERN_C HRESULT WINAPI	SHCreateItemFromIDList (_In_ PCIDLIST_ABSOLUTE pidl, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHCreateItemFromParsingName (_In_ PCWSTR pszPath, _In_opt_ IBindCtx *pbc, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHGetItemFromDataObject (_In_ IDataObject *pdtobj, _In_ DATAOBJ_GET_ITEM_FLAGS dwFlags, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHCreateItemFromRelativeName (_In_ IShellItem *parent, _In_ PCWSTR pszName, _In_opt_ IBindCtx *pbc, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHGetKnownFolderIDList (REFKNOWNFOLDERID rfid, DWORD flags, HANDLE token, PIDLIST_ABSOLUTE *pidl)
EXTERN_C HRESULT WINAPI	SHCreateItemInKnownFolder (_In_ REFKNOWNFOLDERID kfid, _In_ DWORD dwFlags, _In_opt_ PCWSTR pszFileName, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHGetItemFromObject (_In_ IUnknown *punk, _In_ REFIID riid, _Out_ void **ppv)
EXTERN_C HRESULT WINAPI	SHGetPropertyStoreFromParsingName (_In_ PCWSTR pszPath, _In_opt_ IBindCtx *pbc, _In_ GETPROPERTYSTOREFLAGS flags, _In_ REFIID riid, _Out_ void **ppv)

Function Documentation

SHCreateItemFromIDList()

EXTERN_C HRESULT WINAPI SHCreateItemFromIDList	(	_In_ PCIDLIST_ABSOLUTE	pidl,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 340 of file CShellItem.cpp.

{
    CComPtr<IShellItem> item;
    HRESULT hr;
 
    TRACE("(%p,%s,%p)\n", pidl, debugstr_guid(&riid), ppv);
 
    if (!ppv)
        return E_POINTER;
    *ppv = NULL;
 
    if (!pidl)
        return E_INVALIDARG;
 
    hr = SHCreateShellItem(NULL, NULL, pidl, &item);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    return item->QueryInterface(riid, ppv);
}

Referenced by ICommDlgBrowser3_fnIncludeObject(), IExplorerBrowserEvents_fnOnNavigationComplete(), IExplorerBrowserEvents_fnOnNavigationPending(), init_function_pointers(), SHCreateItemFromParsingName(), SHCreateItemFromRelativeName(), SHCreateItemInKnownFolder(), SHGetItemFromDataObject(), and SHGetItemFromObject().

SHCreateItemFromParsingName()

EXTERN_C HRESULT WINAPI SHCreateItemFromParsingName	(	_In_ PCWSTR	pszPath,
		_In_opt_ IBindCtx *	pbc,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 365 of file CShellItem.cpp.

{
    CComHeapPtr<ITEMIDLIST> pidl;
    HRESULT hr;
 
    TRACE("(%s,%p,%s,%p)\n", debugstr_w(pszPath), pbc, debugstr_guid(&riid), ppv);
 
    if (!ppv)
        return E_POINTER;
    *ppv = NULL;
 
    hr = SHParseDisplayName(pszPath, pbc, &pidl, 0, NULL);
    if (SUCCEEDED(hr))
        hr = SHCreateItemFromIDList(pidl, riid, ppv);
 
    return hr;
}

Referenced by init_function_pointers(), SHGetItemFromDataObject(), and SHGetPropertyStoreFromParsingName().

SHCreateItemFromRelativeName()

EXTERN_C HRESULT WINAPI SHCreateItemFromRelativeName	(	_In_ IShellItem *	parent,
		_In_ PCWSTR	pszName,
		_In_opt_ IBindCtx *	pbc,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 499 of file CShellItem.cpp.

{
    CComPtr<IShellFolder> desktop;
    CComPtr<IShellFolder> folder;
    CComHeapPtr<ITEMIDLIST> pidlFolder;
    CComHeapPtr<ITEMIDLIST> pidlChild;
    HRESULT hr;
 
    TRACE("(%p,%s,%p,%s,%p)\n", parent, debugstr_w(pszName), pbc, debugstr_guid(&riid), ppv);
 
    if (!ppv)
        return E_POINTER;
    *ppv = NULL;
 
    if (!pszName)
        return E_INVALIDARG;
 
    hr = SHGetIDListFromObject(parent, &pidlFolder);
    if (hr != S_OK)
        return hr;
 
    hr = SHGetDesktopFolder(&desktop);
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    if (!_ILIsDesktop(pidlFolder))
    {
        hr = desktop->BindToObject(pidlFolder, NULL, IID_PPV_ARG(IShellFolder, &folder));
        if (FAILED_UNEXPECTEDLY(hr))
            return hr;
    }
 
    {
        IShellFolder *psfBind = folder.p ? folder.p : desktop.p;
        hr = psfBind->ParseDisplayName(NULL, pbc, const_cast<LPWSTR>(pszName), NULL, &pidlChild, NULL);
    }
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    return SHCreateItemFromIDList(pidlChild, riid, ppv);
}

Referenced by init_function_pointers(), and SHCreateItemInKnownFolder().

SHCreateItemInKnownFolder()

EXTERN_C HRESULT WINAPI SHCreateItemInKnownFolder	(	_In_ REFKNOWNFOLDERID	kfid,
		_In_ DWORD	dwFlags,
		_In_opt_ PCWSTR	pszFileName,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 556 of file CShellItem.cpp.

{
    TRACE("(%s,%lx,%s,%s,%p)\n", debugstr_guid(&kfid), dwFlags, debugstr_w(pszFileName),
          debugstr_guid(&riid), ppv);
    return E_NOTIMPL;
    //TODO: Import SHGetKnownFolderIDList from wine
#if 0
    CComPtr<IShellItem> parent;
    CComHeapPtr<ITEMIDLIST> pidl;
    HRESULT hr;
 
    TRACE("(%s,%lx,%s,%s,%p)\n", debugstr_guid(&kfid), dwFlags, debugstr_w(pszFileName),
          debugstr_guid(&riid), ppv);
 
    if (!ppv)
        return E_POINTER;
    *ppv = NULL;
 
    hr = SHGetKnownFolderIDList(kfid, dwFlags, NULL, &pidl);
    if (hr != S_OK)
        return hr;
 
    hr = SHCreateItemFromIDList(pidl, IID_PPV_ARG(IShellItem, &parent));
    if (FAILED_UNEXPECTEDLY(hr))
        return hr;
 
    if (pszFileName)
        hr = SHCreateItemFromRelativeName(parent, pszFileName, NULL, riid, ppv);
    else
        hr = parent->QueryInterface(riid, ppv);
 
    return hr;
#endif
}

Referenced by init_function_pointers().

SHCreateShellItem()

HRESULT WINAPI SHCreateShellItem	(	PCIDLIST_ABSOLUTE	pidlParent,
		IShellFolder *	psfParent,
		PCUITEMID_CHILD	pidl,
		IShellItem **	ppsi
	)

Definition at line 261 of file CShellItem.cpp.

{
    HRESULT hr;
    CComPtr<IShellItem> newShellItem;
    LPITEMIDLIST new_pidl;
    CComPtr<IPersistIDList>            newPersistIDList;
 
    TRACE("(%p,%p,%p,%p)\n", pidlParent, psfParent, pidl, ppsi);
 
    *ppsi = NULL;
 
    if (!pidl)
        return E_INVALIDARG;
 
    if (pidlParent || psfParent)
    {
        LPITEMIDLIST temp_parent = NULL;
        if (!pidlParent)
        {
            CComPtr<IPersistFolder2>    ppf2Parent;
 
            if (FAILED(psfParent->QueryInterface(IID_PPV_ARG(IPersistFolder2, &ppf2Parent))))
            {
                FIXME("couldn't get IPersistFolder2 interface of parent\n");
                return E_NOINTERFACE;
            }
 
            if (FAILED(ppf2Parent->GetCurFolder(&temp_parent)))
            {
                FIXME("couldn't get parent PIDL\n");
                return E_NOINTERFACE;
            }
 
            pidlParent = temp_parent;
        }
 
        new_pidl = ILCombine(pidlParent, pidl);
        ILFree(temp_parent);
 
        if (!new_pidl)
            return E_OUTOFMEMORY;
    }
    else
    {
        new_pidl = ILClone(pidl);
        if (!new_pidl)
            return E_OUTOFMEMORY;
    }
 
    hr = CShellItem::_CreatorClass::CreateInstance(NULL, IID_PPV_ARG(IShellItem, &newShellItem));
    if (FAILED(hr))
    {
        ILFree(new_pidl);
        return hr;
    }
    hr = newShellItem->QueryInterface(IID_PPV_ARG(IPersistIDList, &newPersistIDList));
    if (FAILED(hr))
    {
        ILFree(new_pidl);
        return hr;
    }
    hr = newPersistIDList->SetIDList(new_pidl);
    if (FAILED(hr))
    {
        ILFree(new_pidl);
        return hr;
    }
    ILFree(new_pidl);
 
    *ppsi = newShellItem.Detach();
 
    return hr;
}

Referenced by CreateShellItemFromParse(), CShellItemArray::GetItemAt(), CShellItem::GetParent(), init_function_pointers(), SHCreateItemFromIDList(), SHCreateShellItemArray(), and SHCreateShellItemArrayFromIDLists().

SHGetItemFromDataObject()

EXTERN_C HRESULT WINAPI SHGetItemFromDataObject	(	_In_ IDataObject *	pdtobj,
		_In_ DATAOBJ_GET_ITEM_FLAGS	dwFlags,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 391 of file CShellItem.cpp.

{
    FORMATETC fmt;
    STGMEDIUM medium = { 0 };
    HRESULT hr;
 
    TRACE("(%p,%x,%s,%p)\n", pdtobj, dwFlags, debugstr_guid(&riid), ppv);
 
    if (!pdtobj)
        return E_INVALIDARG;
 
    fmt.cfFormat = (CLIPFORMAT)RegisterClipboardFormatW(CFSTR_SHELLIDLISTW);
    fmt.ptd = NULL;
    fmt.dwAspect = DVASPECT_CONTENT;
    fmt.lindex = -1;
    fmt.tymed = TYMED_HGLOBAL;
 
    hr = pdtobj->GetData(&fmt, &medium);
    if (SUCCEEDED(hr))
    {
        LPIDA pida = (LPIDA)GlobalLock(medium.hGlobal);
        if (pida && pida->cidl >= 1 &&
            ((pida->cidl > 1 && !(dwFlags & DOGIF_ONLY_IF_ONE)) || pida->cidl == 1))
        {
            LPITEMIDLIST pidl = ILCombine(HIDA_GetPIDLFolder(pida),
                                          HIDA_GetPIDLItem(pida, 0));
            if (pidl)
            {
                hr = SHCreateItemFromIDList(pidl, riid, ppv);
                ILFree(pidl);
            }
            else
            {
                hr = E_OUTOFMEMORY;
            }
        }
        else
        {
            TRACE("Failed to create item, cidl=%u, dwFlags=%#x\n", pida ? pida->cidl : 0, dwFlags);
            hr = E_FAIL;
        }
 
        if (medium.hGlobal)
        {
            GlobalUnlock(medium.hGlobal);
            ReleaseStgMedium(&medium);
        }
    }
 
    if (FAILED(hr) && !(dwFlags & DOGIF_NO_HDROP))
    {
        TRACE("Attempting to fall back on CF_HDROP.\n");
 
        fmt.cfFormat = CF_HDROP;
        fmt.ptd = NULL;
        fmt.dwAspect = DVASPECT_CONTENT;
        fmt.lindex = -1;
        fmt.tymed = TYMED_HGLOBAL;
        ZeroMemory(&medium, sizeof(medium));
 
        hr = pdtobj->GetData(&fmt, &medium);
        if (SUCCEEDED(hr))
        {
            DROPFILES *df = (DROPFILES *)GlobalLock(medium.hGlobal);
            hr = E_FAIL;
            if (df)
            {
                LPBYTE files = (LPBYTE)df + df->pFiles;
                if (!df->fWide)
                {
                    PCSTR first = (PCSTR)files;
                    BOOL multi = *(first + lstrlenA(first) + 1) != 0;
                    if (!(multi && (dwFlags & DOGIF_ONLY_IF_ONE)))
                    {
                        WCHAR filename[MAX_PATH];
                        MultiByteToWideChar(CP_ACP, 0, first, -1, filename, _countof(filename));
                        hr = SHCreateItemFromParsingName(filename, NULL, riid, ppv);
                    }
                }
                else
                {
                    PCWSTR first = (PCWSTR)files;
                    BOOL multi = *(first + lstrlenW(first) + 1) != 0;
                    if (!(multi && (dwFlags & DOGIF_ONLY_IF_ONE)))
                        hr = SHCreateItemFromParsingName(first, NULL, riid, ppv);
                }
                GlobalUnlock(medium.hGlobal);
            }
            ReleaseStgMedium(&medium);
        }
    }
 
    if (FAILED(hr) && !(dwFlags & DOGIF_NO_URL))
        FIXME("Failed to create item, should try CF_URL.\n");
 
    return hr;
}

Referenced by init_function_pointers().

SHGetItemFromObject()

EXTERN_C HRESULT WINAPI SHGetItemFromObject	(	_In_ IUnknown *	punk,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 600 of file CShellItem.cpp.

{
    CComHeapPtr<ITEMIDLIST> pidl;
    HRESULT hr;
 
    TRACE("(%p,%s,%p)\n", punk, debugstr_guid(&riid), ppv);
 
    hr = SHGetIDListFromObject(punk, &pidl);
    if (SUCCEEDED(hr))
        hr = SHCreateItemFromIDList(pidl, riid, ppv);
    return hr;
}

Referenced by FileDialog_constructor(), and init_function_pointers().

SHGetKnownFolderIDList()

EXTERN_C HRESULT WINAPI SHGetKnownFolderIDList	(	REFKNOWNFOLDERID	rfid,
		DWORD	flags,
		HANDLE	token,
		PIDLIST_ABSOLUTE *	pidl
	)

Referenced by loadShell32(), and SHCreateItemInKnownFolder().

SHGetPropertyStoreFromParsingName()

EXTERN_C HRESULT WINAPI SHGetPropertyStoreFromParsingName	(	_In_ PCWSTR	pszPath,
		_In_opt_ IBindCtx *	pbc,
		_In_ GETPROPERTYSTOREFLAGS	flags,
		_In_ REFIID	riid,
		_Out_ void **	ppv
	)

Definition at line 617 of file CShellItem.cpp.

{
    CComPtr<IShellItem2> item;
    HRESULT hr;
 
    TRACE("(%s,%p,%#x,%s,%p)\n", debugstr_w(pszPath), pbc, flags, debugstr_guid(&riid), ppv);
 
    if (!ppv)
        return E_POINTER;
    *ppv = NULL;
 
    hr = SHCreateItemFromParsingName(pszPath, pbc, IID_PPV_ARG(IShellItem2, &item));
    if (SUCCEEDED(hr))
        hr = item->GetPropertyStore(flags, riid, ppv);
 
    return hr;
}

WINE_DEFAULT_DEBUG_CHANNEL()

WINE_DEFAULT_DEBUG_CHANNEL

(

shell

)