shfldr.h File Reference

#include <ntquery.h>

Include dependency graph for shfldr.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Classes
struct	shvheader
struct	_REQUIREDREGITEM
struct	_REGFOLDERINFO
struct	_REGFOLDERINITDATA

Macros
#define	CHARS_IN_GUID   39
#define	SHFSF_COL_NAME   0
#define	SHFSF_COL_SIZE   1
#define	SHFSF_COL_TYPE   2
#define	SHFSF_COL_MDATE   3
#define	SHFSF_COL_FATTS   4
#define	SHFSF_COL_COMMENT   5
#define	GET_SHGDN_FOR(dwFlags)   ((DWORD)dwFlags & (DWORD)0x0000FF00)
#define	GET_SHGDN_RELATION(dwFlags)   ((DWORD)dwFlags & (DWORD)0x000000FF)
#define	IS_SHGDN_FOR_PARSING(flags)   ( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING)) == SHGDN_FORPARSING)
#define	IS_SHGDN_DESKTOPABSOLUTEPARSING(flags)   ( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING | 0xFF)) == SHGDN_FORPARSING)

Typedefs
typedef struct _REQUIREDREGITEM	REQUIREDREGITEM
typedef struct _REGFOLDERINFO	REGFOLDERINFO
typedef struct _REGFOLDERINITDATA	REGFOLDERINITDATA
typedef struct _REGFOLDERINITDATA *	PREGFOLDERINITDATA

Functions
HRESULT	CRegFolder_CreateInstance (PREGFOLDERINITDATA pInit, LPCITEMIDLIST pidlRoot, REFIID riid, void **ppv)
static SFGAOF	SHELL_CreateFolderEnumItemAttributeQuery (SHCONTF Flags, BOOL ForRegItem)
SHCONTF	SHELL_GetDefaultFolderEnumSHCONTF ()
BOOL	SHELL_IncludeItemInFolderEnum (IShellFolder *pSF, PCUITEMID_CHILD pidl, SFGAOF Query, SHCONTF Flags)
static HRESULT	MakeSCID (SHCOLUMNID &scid, REFCLSID fmtid, UINT pid)
HRESULT	SHELL_MapSCIDToColumn (IShellFolder2 *pSF, const SHCOLUMNID *pscid)
HRESULT	SHELL_GetDetailsOfAsStringVariant (IShellFolder *pSF, PCUITEMID_CHILD pidl, UINT Column, VARIANT *pVar)
HRESULT	SHELL_GetDetailsOfAsStringVariant (IShellFolder2 *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_GetDisplayNameOfChild (IShellFolder2 *psf, LPCITEMIDLIST pidl, DWORD dwFlags, LPSTRRET strRet)
HRESULT	SHELL32_GetFSItemAttributes (IShellFolder *psf, LPCITEMIDLIST pidl, LPDWORD pdwAttributes)
HRESULT	SHELL32_CompareDetails (IShellFolder2 *isf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
HRESULT	SHELL32_CompareChildren (IShellFolder2 *psf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
HRESULT	SHELL32_BindToSF (LPCITEMIDLIST pidlRoot, PERSIST_FOLDER_TARGET_INFO *ppfti, LPCITEMIDLIST pidl, const GUID *clsid, REFIID riid, LPVOID *ppvOut)
BOOL	HCR_RegOpenClassIDKey (REFIID riid, HKEY *hkey)
HRESULT	CDefViewBckgrndMenu_CreateInstance (IShellFolder *psf, REFIID riid, void **ppv)
HRESULT	SH_GetApidlFromDataObject (IDataObject *pDataObject, PIDLIST_ABSOLUTE *ppidlfolder, PUITEMID_CHILD **apidlItems, UINT *pcidl)
static __inline int	SHELL32_GUIDToStringA (REFGUID guid, LPSTR str)
static __inline int	SHELL32_GUIDToStringW (REFGUID guid, LPWSTR str)
void	SHELL_FS_ProcessDisplayFilename (LPWSTR szPath, DWORD dwFlags)
BOOL	SHELL_FS_HideExtension (LPCWSTR pwszPath)
static BOOL	IsIllegalFsFileName (PCWSTR Name)
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)
UINT	SHELL_GetIconUnderlineFlags ()

Macro Definition Documentation

CHARS_IN_GUID

#define CHARS_IN_GUID   39

Definition at line 28 of file shfldr.h.

GET_SHGDN_FOR

#define GET_SHGDN_FOR

(

dwFlags

)

((DWORD)dwFlags & (DWORD)0x0000FF00)

Definition at line 76 of file shfldr.h.

GET_SHGDN_RELATION

#define GET_SHGDN_RELATION

(

dwFlags

)

((DWORD)dwFlags & (DWORD)0x000000FF)

Definition at line 77 of file shfldr.h.

IS_SHGDN_DESKTOPABSOLUTEPARSING

#define IS_SHGDN_DESKTOPABSOLUTEPARSING

(

flags

)

( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING | 0xFF)) == SHGDN_FORPARSING)

Definition at line 79 of file shfldr.h.

IS_SHGDN_FOR_PARSING

#define IS_SHGDN_FOR_PARSING

(

flags

)

( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING)) == SHGDN_FORPARSING)

Definition at line 78 of file shfldr.h.

SHFSF_COL_COMMENT

#define SHFSF_COL_COMMENT   5

Definition at line 49 of file shfldr.h.

SHFSF_COL_FATTS

#define SHFSF_COL_FATTS   4

Definition at line 48 of file shfldr.h.

SHFSF_COL_MDATE

#define SHFSF_COL_MDATE   3

Definition at line 47 of file shfldr.h.

SHFSF_COL_NAME

#define SHFSF_COL_NAME   0

Definition at line 44 of file shfldr.h.

SHFSF_COL_SIZE

#define SHFSF_COL_SIZE   1

Definition at line 45 of file shfldr.h.

SHFSF_COL_TYPE

#define SHFSF_COL_TYPE   2

Definition at line 46 of file shfldr.h.

Typedef Documentation

PREGFOLDERINITDATA

typedef struct _REGFOLDERINITDATA * PREGFOLDERINITDATA

REGFOLDERINFO

typedef struct _REGFOLDERINFO REGFOLDERINFO

REGFOLDERINITDATA

typedef struct _REGFOLDERINITDATA REGFOLDERINITDATA

REQUIREDREGITEM

typedef struct _REQUIREDREGITEM REQUIREDREGITEM

Function Documentation

AddClassKeyToArray()

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

Definition at line 109 of file fontext.cpp.

{
    if (*cKeys >= 16)
        return ERROR_MORE_DATA;
 
    CRegKey key;
    LSTATUS error = key.Open(HKEY_CLASSES_ROOT, szClass, KEY_READ | KEY_QUERY_VALUE);
    if (error == ERROR_SUCCESS)
    {
        array[*cKeys] = key.Detach();
        *cKeys += 1;
    }
    return error;
}

Referenced by AddClsidKeyToArray(), AddFSClassKeysToArray(), CDrivesContextMenu_CreateInstance(), ClassPropDialogInitCallback(), CDesktopFolder::CreateViewObject(), CFSFolder::CreateViewObject(), CRegItemContextMenu_CreateInstance(), CDesktopFolder::GetUIObjectOf(), and CNetFolder::GetUIObjectOf().

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().

CDefViewBckgrndMenu_CreateInstance()

HRESULT CDefViewBckgrndMenu_CreateInstance	(	IShellFolder *	psf,
		REFIID	riid,
		void **	ppv
	)

Definition at line 330 of file CDefViewBckgrndMenu.cpp.

{
    return ShellObjectCreatorInit<CDefViewBckgrndMenu>(psf, riid, ppv);
}

Referenced by CDefView::GetItemObject().

CloseRegKeyArray()

void CloseRegKeyArray	(	HKEY *	array,
		UINT	cKeys
	)

Definition at line 103 of file fontext.cpp.

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

CRegFolder_CreateInstance()

HRESULT CRegFolder_CreateInstance	(	PREGFOLDERINITDATA	pInit,
		LPCITEMIDLIST	pidlRoot,
		REFIID	riid,
		void **	ppv
	)

Definition at line 995 of file CRegFolder.cpp.

{
    return ShellObjectCreatorInit<CRegFolder>(pInit, pidlRoot, riid, ppv);
}

Referenced by CDesktopFolder::FinalConstruct(), CDrivesFolder::FinalConstruct(), and CControlPanelFolder::Initialize().

HCR_RegOpenClassIDKey()

BOOL HCR_RegOpenClassIDKey	(	REFIID	riid,
		HKEY *	hkey
	)

Definition at line 253 of file classes.c.

{
    char    xriid[50];
    sprintf( xriid, "CLSID\\{%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}",
                 (UINT)riid->Data1, riid->Data2, riid->Data3,
                 riid->Data4[0], riid->Data4[1], riid->Data4[2], riid->Data4[3],
                 riid->Data4[4], riid->Data4[5], riid->Data4[6], riid->Data4[7] );
 
    TRACE("%s\n",xriid );
 
    return !RegOpenKeyExA(HKEY_CLASSES_ROOT, xriid, 0, KEY_READ, hkey);
}

Referenced by CRegFolder::GetDetailsOf(), CRegFolder::GetDisplayNameOf(), HCR_GetClassNameA(), and HCR_GetClassNameW().

IsIllegalFsFileName()

static BOOL IsIllegalFsFileName ( PCWSTR  Name )

inlinestatic

Definition at line 183 of file shfldr.h.

{
    return StrIsNullOrEmpty(Name) || StrPBrkW(Name, INVALID_FILETITLE_CHARACTERSW);
}

Referenced by CRegFolder::SetNameOf().

MakeSCID()

static HRESULT MakeSCID ( SHCOLUMNID &  scid, REFCLSID  fmtid, UINT  pid  )

inlinestatic

Definition at line 99 of file shfldr.h.

{
    scid.fmtid = fmtid;
    scid.pid = pid;
    return S_OK;
}

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

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().

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_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_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_GetFSItemAttributes()

HRESULT SHELL32_GetFSItemAttributes	(	IShellFolder *	psf,
		LPCITEMIDLIST	pidl,
		LPDWORD	pdwAttributes
	)

Definition at line 644 of file CFSFolder.cpp.

{
    DWORD dwFileAttributes, dwShellAttributes;
 
    if (!_ILIsFolderOrFile(pidl))
    {
        ERR("Got wrong type of pidl!\n");
        *pdwAttributes &= SFGAO_CANLINK;
        return S_OK;
    }
 
    dwFileAttributes = _ILGetFileAttributes(pidl, NULL, 0);
 
    /* Set common attributes */
    dwShellAttributes = SFGAO_CANCOPY | SFGAO_CANMOVE | SFGAO_CANLINK | SFGAO_CANRENAME | SFGAO_CANDELETE |
                        SFGAO_HASPROPSHEET | SFGAO_DROPTARGET | SFGAO_FILESYSTEM;
 
    BOOL bDirectory = (dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY) != 0;
 
    if (SFGAO_VALIDATE & *pdwAttributes)
    {
        STRRET strret;
        LPWSTR path;
        if (SUCCEEDED(psf->GetDisplayNameOf(pidl, SHGDN_FORPARSING, &strret)) &&
            SUCCEEDED(StrRetToStrW(&strret, pidl, &path)))
        {
            BOOL exists = PathFileExistsW(path);
            SHFree(path);
            if (!exists)
                return E_FAIL;
        }
    }
 
    if (!bDirectory)
    {
        // https://git.reactos.org/?p=reactos.git;a=blob;f=dll/shellext/zipfldr/res/zipfldr.rgs;hb=032b5aacd233cd7b83ab6282aad638c161fdc400#l9
        WCHAR szFileName[MAX_PATH];
        LPWSTR pExtension;
        BOOL hasName = _ILSimpleGetTextW(pidl, szFileName, _countof(szFileName));
        dwShellAttributes |= SFGAO_STREAM;
 
        // Vista+ feature: Hidden files with a leading tilde treated as super-hidden
        // See https://devblogs.microsoft.com/oldnewthing/20170526-00/?p=96235
        if (hasName && szFileName[0] == '~' && (dwFileAttributes & FILE_ATTRIBUTE_HIDDEN))
            dwShellAttributes |= SFGAO_HIDDEN | SFGAO_SYSTEM;
 
        if (hasName && (pExtension = PathFindExtensionW(szFileName)))
        {
            CLSID clsidFile;
            // FIXME: Cache this?
            HRESULT hr = GetCLSIDForFileTypeFromExtension(pExtension, L"CLSID", &clsidFile);
            if (hr == S_OK)
            {
                HKEY hkey;
                hr = SHRegGetCLSIDKeyW(clsidFile, L"ShellFolder", FALSE, FALSE, &hkey);
                if (SUCCEEDED(hr))
                {
                    DWORD dwAttributes = 0;
                    DWORD dwSize = sizeof(dwAttributes);
                    LSTATUS Status;
 
                    Status = SHRegGetValueW(hkey, NULL, L"Attributes", RRF_RT_REG_DWORD, NULL, &dwAttributes, &dwSize);
                    if (Status == STATUS_SUCCESS)
                    {
                        TRACE("Augmenting '%S' with dwAttributes=0x%x\n", szFileName, dwAttributes);
                        dwShellAttributes |= dwAttributes;
                    }
                    ::RegCloseKey(hkey);
 
                    // This should be presented as directory!
                    bDirectory = (dwAttributes & SFGAO_FOLDER) != 0 || dwAttributes == 0;
                    TRACE("Treating '%S' as directory!\n", szFileName);
                }
            }
        }
    }
 
    // This is a directory
    if (bDirectory)
    {
        dwShellAttributes |= (SFGAO_FOLDER | /*SFGAO_HASSUBFOLDER |*/ SFGAO_STORAGE);
 
        // Is this a real directory?
        if (dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)
        {
            dwShellAttributes |= (SFGAO_FILESYSANCESTOR | SFGAO_STORAGEANCESTOR);
        }
    }
 
    if (dwFileAttributes & FILE_ATTRIBUTE_HIDDEN)
        dwShellAttributes |= SFGAO_HIDDEN | SFGAO_GHOSTED;
 
    if (dwFileAttributes & FILE_ATTRIBUTE_READONLY)
        dwShellAttributes |= SFGAO_READONLY;
 
    if (dwFileAttributes & FILE_ATTRIBUTE_SYSTEM)
        dwShellAttributes |= SFGAO_SYSTEM;
 
    if (dwFileAttributes & FILE_ATTRIBUTE_COMPRESSED)
        dwShellAttributes |= SFGAO_COMPRESSED;
 
    if (dwFileAttributes & FILE_ATTRIBUTE_ENCRYPTED)
        dwShellAttributes |= SFGAO_ENCRYPTED;
 
    if ((SFGAO_NONENUMERATED & *pdwAttributes) && (dwFileAttributes & FILE_ATTRIBUTE_HIDDEN))
    {
        SHCONTF shcf = SHELL_GetDefaultFolderEnumSHCONTF();
        if ((!(shcf & SHCONTF_INCLUDEHIDDEN)) || ((dwFileAttributes & FILE_ATTRIBUTE_SYSTEM) && !(shcf & SHCONTF_INCLUDESUPERHIDDEN)))
            dwShellAttributes |= SFGAO_NONENUMERATED;
    }
 
    if (SFGAO_LINK & *pdwAttributes)
    {
        WCHAR ext[MAX_PATH];
 
        if (_ILGetExtension(pidl, ext, _countof(ext)) && !lstrcmpiW(ext, L"lnk"))
            dwShellAttributes |= SFGAO_LINK;
    }
 
    if (SFGAO_HASSUBFOLDER & *pdwAttributes)
    {
        CComPtr<IShellFolder> psf2;
        if (SUCCEEDED(psf->BindToObject(pidl, 0, IID_PPV_ARG(IShellFolder, &psf2))))
        {
            CComPtr<IEnumIDList> pEnumIL;
            if (SUCCEEDED(psf2->EnumObjects(0, SHCONTF_FOLDERS, &pEnumIL)))
            {
                if (pEnumIL->Skip(1) == S_OK)
                    dwShellAttributes |= SFGAO_HASSUBFOLDER;
            }
        }
    }
 
    *pdwAttributes = dwShellAttributes;
 
    TRACE ("-- 0x%08x\n", *pdwAttributes);
    return S_OK;
}

Referenced by CFSFolder::GetAttributesOf().

SHELL32_GUIDToStringA()

static __inline int SHELL32_GUIDToStringA ( REFGUID  guid, LPSTR  str  )

static

Definition at line 159 of file shfldr.h.

{
    return sprintf(str, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
            guid.Data1, guid.Data2, guid.Data3,
            guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
            guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
}

SHELL32_GUIDToStringW()

static __inline int SHELL32_GUIDToStringW ( REFGUID  guid, LPWSTR  str  )

static

Definition at line 167 of file shfldr.h.

{
    static const WCHAR fmtW[] =
     { '{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
     '%','0','2','X','%','0','2','X','-',
     '%','0','2','X','%','0','2','X','%','0','2','X','%','0','2','X',
     '%','0','2','X','%','0','2','X','}',0 };
    return _swprintf(str, fmtW,
            guid.Data1, guid.Data2, guid.Data3,
            guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
            guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
}

Referenced by CRegFolder::GetDisplayNameOf(), and SHELL32_IsShellFolderNamespaceItemHidden().

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().

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_CreateFolderEnumItemAttributeQuery()

static SFGAOF SHELL_CreateFolderEnumItemAttributeQuery ( SHCONTF  Flags, BOOL  ForRegItem  )

inlinestatic

Definition at line 82 of file shfldr.h.

{
    SFGAOF query = SFGAO_FOLDER | (ForRegItem ? SFGAO_NONENUMERATED : 0);
    if (!(Flags & SHCONTF_INCLUDEHIDDEN))
        query |= SFGAO_HIDDEN;
    if (!(Flags & SHCONTF_INCLUDESUPERHIDDEN))
        query |= SFGAO_HIDDEN | SFGAO_SYSTEM;
    return query;
}

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

SHELL_FS_HideExtension()

BOOL SHELL_FS_HideExtension

(

LPCWSTR

pwszPath

)

Definition at line 1444 of file CFSFolder.cpp.

{
    HKEY hKey;
    BOOL doHide = FALSE; /* The default value is FALSE (win98 at least) */
    LONG lError;
 
    doHide = !SHELL_GetSetting(SSF_SHOWEXTENSIONS, fShowExtensions);
 
    if (!doHide)
    {
        LPCWSTR DotExt = PathFindExtensionW(szPath);
        if (*DotExt != 0)
        {
            WCHAR classname[MAX_PATH];
            LONG classlen = sizeof(classname);
            lError = RegQueryValueW(HKEY_CLASSES_ROOT, DotExt, classname, &classlen);
            if (lError == ERROR_SUCCESS)
            {
                lError = RegOpenKeyW(HKEY_CLASSES_ROOT, classname, &hKey);
                if (lError == ERROR_SUCCESS)
                {
                    lError = RegQueryValueExW(hKey, L"NeverShowExt", NULL, NULL, NULL, NULL);
                    if (lError == ERROR_SUCCESS)
                        doHide = TRUE;
 
                    RegCloseKey(hKey);
                }
            }
        }
    }
    // TODO: else if "AlwaysShowExt"
 
    return doHide;
}

Referenced by CDefView::OnNotify(), CFSFolder::SetNameOf(), and SHELL_FS_ProcessDisplayFilename().

SHELL_FS_ProcessDisplayFilename()

void SHELL_FS_ProcessDisplayFilename	(	LPWSTR	szPath,
		DWORD	dwFlags
	)

Definition at line 1479 of file CFSFolder.cpp.

{
    /*FIXME: MSDN also mentions SHGDN_FOREDITING which is not yet handled. */
    if (!(dwFlags & SHGDN_FORPARSING) &&
        ((dwFlags & SHGDN_INFOLDER) || (dwFlags == SHGDN_NORMAL))) {
            if (SHELL_FS_HideExtension(szPath) && szPath[0] != '.')
                PathRemoveExtensionW(szPath);
    }
}

Referenced by CFSFolder::GetDisplayNameOf(), and CRecycleBin::GetDisplayNameOf().

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_GetIconUnderlineFlags()

UINT SHELL_GetIconUnderlineFlags

(

)

Definition at line 134 of file general.cpp.

{
    UINT mode = SHELL_GetIconUnderlineMode();
    if (mode == UNDERLINE_HOVER)
        return LVS_EX_UNDERLINEHOT;
    if (mode == UNDERLINE_ON)
        return LVS_EX_UNDERLINEHOT | LVS_EX_UNDERLINECOLD;
    return 0;
}

Referenced by CDefView::CreateList(), and CDefView::OnSettingChange().

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().