1
2 /*
3 * Virtual Folder
4 * common definitions
5 *
6 * Copyright 1997 Marcus Meissner
7 * Copyright 1998, 1999, 2002 Juergen Schmied
8 *
9 * This library is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU Lesser General Public
11 * License as published by the Free Software Foundation; either
12 * version 2.1 of the License, or (at your option) any later version.
13 *
14 * This library is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * Lesser General Public License for more details.
18 *
19 * You should have received a copy of the GNU Lesser General Public
20 * License along with this library; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 */
23
24 #ifndef _SHFLDR_H_
25 #define _SHFLDR_H_
26
27 #define CHARS_IN_GUID 39
28
29 typedef struct {
30 WORD colnameid; // Column title text resource id passed to LoadString
31 WORD colstate; // SHCOLSTATEF returned by IShellFolder2::GetDefaultColumnState
32 // HACK: SHCOLSTATEF truncated to WORD to reduce .rdata section size
33 WORD fmt; // LVCFMT_*
34 WORD cxChar; // Column width hint
35 } shvheader;
36 /*
37 * CFSFolder column indices. CDesktopFolder MUST use the same indices!
38 * According to the documentation for IShellFolder2::GetDetailsOf,
39 * the first 4 columns for SFGAO_FILESYSTEM items must be Name, Size, Type, Modified date
40 For Details See:
41 https://learn.microsoft.com/en-us/windows/win32/api/shobjidl_core/nf-shobjidl_core-ishellfolder2-getdetailsof
42 */
43 #define SHFSF_COL_NAME 0
44 #define SHFSF_COL_SIZE 1
45 #define SHFSF_COL_TYPE 2 // SHGFI_TYPENAME
46 #define SHFSF_COL_MDATE 3 // Modified date
47 #define SHFSF_COL_FATTS 4 // File attributes
48 #define SHFSF_COL_COMMENT 5
49
50 typedef struct _REQUIREDREGITEM
51 {
52 REFCLSID clsid;
53 LPCSTR pszCpl;
54 BYTE Order; // According to Geoff Chappell, required items have a fixed sort order
55 } REQUIREDREGITEM;
56
57 typedef struct _REGFOLDERINFO
58 {
59 PIDLTYPE PidlType;
60 BYTE Count; // Count of required items
61 const REQUIREDREGITEM *Items;
62 REFCLSID clsid;
63 LPCWSTR pszParsingPath;
64 LPCWSTR pszEnumKeyName;
65 } REGFOLDERINFO;
66
67 typedef struct _REGFOLDERINITDATA
68 {
69 IShellFolder *psfOuter;
70 const REGFOLDERINFO *pInfo;
71 } REGFOLDERINITDATA, *PREGFOLDERINITDATA;
72
73 HRESULT CRegFolder_CreateInstance(PREGFOLDERINITDATA pInit, LPCITEMIDLIST pidlRoot, REFIID riid, void **ppv);
74
75 #define GET_SHGDN_FOR(dwFlags) ((DWORD)dwFlags & (DWORD)0x0000FF00)
76 #define GET_SHGDN_RELATION(dwFlags) ((DWORD)dwFlags & (DWORD)0x000000FF)
77 #define IS_SHGDN_FOR_PARSING(flags) ( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING)) == SHGDN_FORPARSING)
78 #define IS_SHGDN_DESKTOPABSOLUTEPARSING(flags) ( ((flags) & (SHGDN_FORADDRESSBAR | SHGDN_FORPARSING | 0xFF)) == SHGDN_FORPARSING)
79
80 static inline SFGAOF
SHELL_CreateFolderEnumItemAttributeQuery(SHCONTF Flags,BOOL ForRegItem)81 SHELL_CreateFolderEnumItemAttributeQuery(SHCONTF Flags, BOOL ForRegItem)
82 {
83 SFGAOF query = SFGAO_FOLDER | (ForRegItem ? SFGAO_NONENUMERATED : 0);
84 if (!(Flags & SHCONTF_INCLUDEHIDDEN))
85 query |= SFGAO_HIDDEN;
86 if (!(Flags & SHCONTF_INCLUDESUPERHIDDEN))
87 query |= SFGAO_HIDDEN | SFGAO_SYSTEM;
88 return query;
89 }
90
91 SHCONTF
92 SHELL_GetDefaultFolderEnumSHCONTF();
93
94 BOOL
95 SHELL_IncludeItemInFolderEnum(IShellFolder *pSF, PCUITEMID_CHILD pidl, SFGAOF Query, SHCONTF Flags);
96
97 HRESULT
98 Shell_NextElement(
99 _Inout_ LPWSTR *ppch,
100 _Out_ LPWSTR pszOut,
101 _In_ INT cchOut,
102 _In_ BOOL bValidate);
103
104 HRESULT SHELL32_ParseNextElement (IShellFolder2 * psf, HWND hwndOwner, LPBC pbc, LPITEMIDLIST * pidlInOut,
105 LPOLESTR szNext, DWORD * pEaten, DWORD * pdwAttributes);
106
107 HRESULT SHELL32_GetDisplayNameOfChild (IShellFolder2 * psf, LPCITEMIDLIST pidl, DWORD dwFlags, LPSTRRET strRet);
108
109 HRESULT SHELL32_GetFSItemAttributes(IShellFolder * psf, LPCITEMIDLIST pidl, LPDWORD pdwAttributes);
110
111 HRESULT SHELL32_CompareDetails(IShellFolder2* isf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2);
112
113 HRESULT SHELL32_CompareChildren(IShellFolder2* psf, LPARAM lParam, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2);
114
115 #ifdef __cplusplus
116 HRESULT SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, PERSIST_FOLDER_TARGET_INFO* ppfti,
117 LPCITEMIDLIST pidlChild, const GUID* clsid, REFIID riid, LPVOID *ppvOut);
118
119 HRESULT SHELL32_CoCreateInitSF (LPCITEMIDLIST pidlRoot, const GUID* clsid,
120 int csidl, REFIID riid, LPVOID *ppvOut);
121 #endif
122
123 HRESULT SHELL32_BindToSF (LPCITEMIDLIST pidlRoot, PERSIST_FOLDER_TARGET_INFO* ppfti,
124 LPCITEMIDLIST pidl, const GUID* clsid, REFIID riid, LPVOID *ppvOut);
125
126 extern "C"
127 BOOL HCR_RegOpenClassIDKey(REFIID riid, HKEY *hkey);
128
129 HRESULT CDefViewBckgrndMenu_CreateInstance(IShellFolder* psf, REFIID riid, void **ppv);
130
131 HRESULT SH_GetApidlFromDataObject(IDataObject *pDataObject, PIDLIST_ABSOLUTE* ppidlfolder, PUITEMID_CHILD **apidlItems, UINT *pcidl);
132
SHELL32_GUIDToStringA(REFGUID guid,LPSTR str)133 static __inline int SHELL32_GUIDToStringA (REFGUID guid, LPSTR str)
134 {
135 return sprintf(str, "{%08X-%04X-%04X-%02X%02X-%02X%02X%02X%02X%02X%02X}",
136 guid.Data1, guid.Data2, guid.Data3,
137 guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
138 guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
139 }
140
SHELL32_GUIDToStringW(REFGUID guid,LPWSTR str)141 static __inline int SHELL32_GUIDToStringW (REFGUID guid, LPWSTR str)
142 {
143 static const WCHAR fmtW[] =
144 { '{','%','0','8','l','X','-','%','0','4','X','-','%','0','4','X','-',
145 '%','0','2','X','%','0','2','X','-',
146 '%','0','2','X','%','0','2','X','%','0','2','X','%','0','2','X',
147 '%','0','2','X','%','0','2','X','}',0 };
148 return swprintf(str, fmtW,
149 guid.Data1, guid.Data2, guid.Data3,
150 guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3],
151 guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
152 }
153
154 void SHELL_FS_ProcessDisplayFilename(LPWSTR szPath, DWORD dwFlags);
155 BOOL SHELL_FS_HideExtension(LPCWSTR pwszPath);
156
157 void CloseRegKeyArray(HKEY* array, UINT cKeys);
158 LSTATUS AddClassKeyToArray(const WCHAR* szClass, HKEY* array, UINT* cKeys);
159 LSTATUS AddClsidKeyToArray(REFCLSID clsid, HKEY* array, UINT* cKeys);
160 void AddFSClassKeysToArray(UINT cidl, PCUITEMID_CHILD_ARRAY apidl, HKEY* array, UINT* cKeys);
161
162 #ifdef __cplusplus
163
164 struct CRegKeyHandleArray
165 {
166 HKEY hKeys[16];
167 UINT cKeys;
168
CRegKeyHandleArrayCRegKeyHandleArray169 CRegKeyHandleArray() : cKeys(0) {}
~CRegKeyHandleArrayCRegKeyHandleArray170 ~CRegKeyHandleArray() { CloseRegKeyArray(hKeys, cKeys); }
171 operator HKEY*() { return hKeys; }
172 operator UINT*() { return &cKeys; }
UINTCRegKeyHandleArray173 operator UINT() { return cKeys; }
174 HKEY& operator [](SIZE_T i) { return hKeys[i]; }
175 };
176
SHSetStrRet(LPSTRRET pStrRet,DWORD resId)177 HRESULT inline SHSetStrRet(LPSTRRET pStrRet, DWORD resId)
178 {
179 return SHSetStrRet(pStrRet, shell32_hInstance, resId);
180 }
181
182 #endif
183
184 #endif /* _SHFLDR_H_ */
185