ReactOS 0.4.15-dev-8102-g108db8f
CShellLink.h
Go to the documentation of this file.
1/*
2 *
3 * Copyright 1997 Marcus Meissner
4 * Copyright 1998 Juergen Schmied
5 * Copyright 2005 Mike McCormack
6 * Copyright 2009 Andrew Hill
7 * Copyright 2017 Hermes Belusca-Maito
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
25#ifndef _SHELLLINK_H_
26#define _SHELLLINK_H_
27
29 public CComCoClass<CShellLink, &CLSID_ShellLink>,
30 public CComObjectRootEx<CComMultiThreadModelNoCS>,
31 public IShellLinkA,
32 public IShellLinkW,
33 public IPersistStream,
34 public IPersistFile,
35 public IShellExtInit,
36 public IContextMenu, // Technically it should be IContextMenu3 (inherits from IContextMenu2 and IContextMenu)
37 public IDropTarget,
38// public IQueryInfo,
39 public IShellLinkDataList,
40 public IExtractIconA,
41 public IExtractIconW,
42// public IExtractImage2, // Inherits from IExtractImage
43// public IPersistPropertyBag,
44// public IServiceProvider,
45// public IFilter,
46 public IObjectWithSite,
47// public ICustomizeInfoTip,
49{
50public:
51 /* Link file formats */
52
53 #include "pshpack1.h"
55 {
58 WCHAR label[12]; /* assume 8.3 */
59 };
60 #include "poppack.h"
61
62 enum IDCMD
63 {
66 };
67
68private:
69 /* Cached link header */
71
72 /* Cached data set according to m_Header.dwFlags (SHELL_LINK_DATA_FLAGS) */
73
75
76 /* Link tracker information */
79
87 LPDBLIST m_pDBList; /* Optional data block list (in the extra data section) */
88 BOOL m_bInInit; // in initialization or not
91
92 /* Pointers to strings inside Logo3/Darwin info blocks, cached for debug info purposes only */
95
97
98 CComPtr<IUnknown> m_site;
99 CComPtr<IDropTarget> m_DropTarget;
100
101 VOID Reset();
102
108
111
112public:
113 CShellLink();
114 ~CShellLink();
116
117 BOOL OnInitDialog(HWND hwndDlg, HWND hwndFocus, LPARAM lParam);
118 void OnCommand(HWND hwndDlg, int id, HWND hwndCtl, UINT codeNotify);
119 LRESULT OnNotify(HWND hwndDlg, int idFrom, LPNMHDR pnmhdr);
120 void OnDestroy(HWND hwndDlg);
121
122 // IPersistFile
123 STDMETHOD(GetClassID)(CLSID *pclsid) override;
124 STDMETHOD(IsDirty)() override;
125 STDMETHOD(Load)(LPCOLESTR pszFileName, DWORD dwMode) override;
126 STDMETHOD(Save)(LPCOLESTR pszFileName, BOOL fRemember) override;
127 STDMETHOD(SaveCompleted)(LPCOLESTR pszFileName) override;
128 STDMETHOD(GetCurFile)(LPOLESTR *ppszFileName) override;
129
130 // IPersistStream
131 // STDMETHOD(GetClassID)(CLSID *pclsid) override;
132 // STDMETHOD(IsDirty)() override;
133 STDMETHOD(Load)(IStream *stm) override;
134 STDMETHOD(Save)(IStream *stm, BOOL fClearDirty) override;
135 STDMETHOD(GetSizeMax)(ULARGE_INTEGER *pcbSize) override;
136
137 // IShellLinkA
138 STDMETHOD(GetPath)(LPSTR pszFile, INT cchMaxPath, WIN32_FIND_DATAA *pfd, DWORD fFlags) override;
139 STDMETHOD(GetIDList)(PIDLIST_ABSOLUTE *ppidl) override;
140 STDMETHOD(SetIDList)(PCIDLIST_ABSOLUTE pidl) override;
141 STDMETHOD(GetDescription)(LPSTR pszName, INT cchMaxName) override;
142 STDMETHOD(SetDescription)(LPCSTR pszName) override;
143 STDMETHOD(GetWorkingDirectory)(LPSTR pszDir, INT cchMaxPath) override;
145 STDMETHOD(GetArguments)(LPSTR pszArgs, INT cchMaxPath) override;
146 STDMETHOD(SetArguments)(LPCSTR pszArgs) override;
147 STDMETHOD(GetHotkey)(WORD *pwHotkey) override;
148 STDMETHOD(SetHotkey)(WORD wHotkey) override;
149 STDMETHOD(GetShowCmd)(INT *piShowCmd) override;
150 STDMETHOD(SetShowCmd)(INT iShowCmd) override;
151 STDMETHOD(GetIconLocation)(LPSTR pszIconPath, INT cchIconPath, INT *piIcon) override;
152 STDMETHOD(SetIconLocation)(LPCSTR pszIconPath, INT iIcon) override;
153 STDMETHOD(SetRelativePath)(LPCSTR pszPathRel, DWORD dwReserved) override;
154 STDMETHOD(Resolve)(HWND hwnd, DWORD fFlags) override;
155 STDMETHOD(SetPath)(LPCSTR pszFile) override;
156
157 // IShellLinkW
158 STDMETHOD(GetPath)(LPWSTR pszFile, INT cchMaxPath, WIN32_FIND_DATAW *pfd, DWORD fFlags) override;
159 // STDMETHOD(GetIDList)(PIDLIST_ABSOLUTE *ppidl) override;
160 // STDMETHOD(SetIDList)(PCIDLIST_ABSOLUTE pidl) override;
161 STDMETHOD(GetDescription)(LPWSTR pszName, INT cchMaxName) override;
162 STDMETHOD(SetDescription)(LPCWSTR pszName) override;
163 STDMETHOD(GetWorkingDirectory)(LPWSTR pszDir, INT cchMaxPath) override;
165 STDMETHOD(GetArguments)(LPWSTR pszArgs, INT cchMaxPath) override;
166 STDMETHOD(SetArguments)(LPCWSTR pszArgs) override;
167 // STDMETHOD(GetHotkey)(WORD *pwHotkey) override;
168 // STDMETHOD(SetHotkey)(WORD wHotkey) override;
169 // STDMETHOD(GetShowCmd)(INT *piShowCmd) override;
170 // STDMETHOD(SetShowCmd)(INT iShowCmd) override;
171 STDMETHOD(GetIconLocation)(LPWSTR pszIconPath, INT cchIconPath, INT *piIcon) override;
172 STDMETHOD(SetIconLocation)(LPCWSTR pszIconPath, INT iIcon) override;
173 STDMETHOD(SetRelativePath)(LPCWSTR pszPathRel, DWORD dwReserved) override;
174 // STDMETHOD(Resolve)(HWND hwnd, DWORD fFlags) override;
175 STDMETHOD(SetPath)(LPCWSTR pszFile) override;
176
177 // IShellLinkDataList
178 STDMETHOD(AddDataBlock)(void *pDataBlock) override;
179 STDMETHOD(CopyDataBlock)(DWORD dwSig, void **ppDataBlock) override;
180 STDMETHOD(RemoveDataBlock)(DWORD dwSig) override;
181 STDMETHOD(GetFlags)(DWORD *pdwFlags) override;
182 STDMETHOD(SetFlags)(DWORD dwFlags) override;
183
184 // IExtractIconA
185 STDMETHOD(Extract)(PCSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize) override;
186 STDMETHOD(GetIconLocation)(UINT uFlags, PSTR pszIconFile, UINT cchMax, int *piIndex, UINT *pwFlags) override;
187
188 // IExtractIconW
189 STDMETHOD(Extract)(PCWSTR pszFile, UINT nIconIndex, HICON *phiconLarge, HICON *phiconSmall, UINT nIconSize) override;
190 STDMETHOD(GetIconLocation)(UINT uFlags, PWSTR pszIconFile, UINT cchMax, int *piIndex, UINT *pwFlags) override;
191
192 // IShellExtInit
193 STDMETHOD(Initialize)(PCIDLIST_ABSOLUTE pidlFolder, IDataObject *pdtobj, HKEY hkeyProgID) override;
194
195 // IContextMenu
196 STDMETHOD(QueryContextMenu)(HMENU hmenu, UINT indexMenu, UINT idCmdFirst, UINT idCmdLast, UINT uFlags) override;
198 STDMETHOD(GetCommandString)(UINT_PTR idCmd, UINT uType, UINT *pwReserved, LPSTR pszName, UINT cchMax) override;
199
200 // IShellPropSheetExt
201 STDMETHOD(AddPages)(LPFNADDPROPSHEETPAGE pfnAddPage, LPARAM lParam) override;
202 STDMETHOD(ReplacePage)(UINT uPageID, LPFNADDPROPSHEETPAGE pfnReplacePage, LPARAM lParam) override;
203
204 // IObjectWithSite
205 STDMETHOD(SetSite)(IUnknown *punk) override;
206 STDMETHOD(GetSite)(REFIID iid, void **ppvSite) override;
207
208 // IDropTarget
209 STDMETHOD(DragEnter)(IDataObject *pDataObject, DWORD dwKeyState, POINTL pt, DWORD *pdwEffect) override;
210 STDMETHOD(DragOver)(DWORD dwKeyState, POINTL pt, DWORD *pdwEffect) override;
211 STDMETHOD(DragLeave)() override;
212 STDMETHOD(Drop)(IDataObject *pDataObject, DWORD dwKeyState, POINTL pt, DWORD *pdwEffect) override;
213
216
218
220 COM_INTERFACE_ENTRY_IID(IID_IShellLinkA, IShellLinkA)
221 COM_INTERFACE_ENTRY_IID(IID_IShellLinkW, IShellLinkW)
225 COM_INTERFACE_ENTRY_IID(IID_IShellExtInit, IShellExtInit)
226 COM_INTERFACE_ENTRY_IID(IID_IContextMenu, IContextMenu) // Technically it should be IContextMenu3
227 COM_INTERFACE_ENTRY_IID(IID_IDropTarget, IDropTarget)
228// COM_INTERFACE_ENTRY_IID(IID_IQueryInfo, IQueryInfo)
229 COM_INTERFACE_ENTRY_IID(IID_IShellLinkDataList, IShellLinkDataList)
230 COM_INTERFACE_ENTRY_IID(IID_IExtractIconA, IExtractIconA)
231 COM_INTERFACE_ENTRY_IID(IID_IExtractIconW, IExtractIconW)
232// COM_INTERFACE_ENTRY_IID(IID_IExtractImage2, IExtractImage2)
233// COM_INTERFACE_ENTRY_IID(IID_IPersistPropertyBag, IPersistPropertyBag)
234// COM_INTERFACE_ENTRY_IID(IID_IServiceProvider, IServiceProvider)
235// COM_INTERFACE_ENTRY_IID(IID_IFilter, IFilter)
237// COM_INTERFACE_ENTRY_IID(IID_ICustomizeInfoTip, ICustomizeInfoTip)
238 COM_INTERFACE_ENTRY_IID(IID_IShellPropSheetExt, IShellPropSheetExt)
240};
241
242#endif /* _SHELLLINK_H_ */
UINT cchMax
#define STDMETHOD(m)
Definition: basetyps.h:62
WPARAM wParam
Definition: combotst.c:138
LPARAM lParam
Definition: combotst.c:139
UINT uFlags
Definition: api.c:59
#define CALLBACK
Definition: compat.h:35
static const WCHAR IconIndex[]
Definition: install.c:52
#define pt(x, y)
Definition: drawing.c:79
unsigned int BOOL
Definition: ntddk_ex.h:94
unsigned long DWORD
Definition: ntddk_ex.h:95
unsigned short WORD
Definition: ntddk_ex.h:93
#define COM_INTERFACE_ENTRY2_IID(iid, x, x2)
Definition: atlcom.h:609
#define BEGIN_COM_MAP(x)
Definition: atlcom.h:581
#define COM_INTERFACE_ENTRY_IID(iid, x)
Definition: atlcom.h:601
#define DECLARE_PROTECT_FINAL_CONSTRUCT()
Definition: atlcom.h:679
#define DECLARE_NOT_AGGREGATABLE(x)
Definition: atlcom.h:651
#define DECLARE_REGISTRY_RESOURCEID(x)
Definition: atlcom.h:645
#define END_COM_MAP()
Definition: atlcom.h:592
int DoOpen(void)
Definition: cmds.c:2168
static HICON
Definition: imagelist.c:84
const IID IID_IObjectWithSite
static LPOLESTR
Definition: stg_prop.c:27
static const CLSID *static CLSID *static const GUID VARIANT VARIANT *static IServiceProvider DWORD *static HMENU
Definition: ordinal.c:63
unsigned __int3264 UINT_PTR
Definition: mstsclib_h.h:274
_In_ HANDLE _In_ DWORD _In_ DWORD _Inout_opt_ LPOVERLAPPED _In_opt_ LPTRANSMIT_FILE_BUFFERS _In_ DWORD dwReserved
Definition: mswsock.h:95
unsigned int UINT
Definition: ndis.h:50
const GUID IID_IPersistFile
const GUID IID_IPersist
Definition: proxy.cpp:14
const GUID IID_IPersistStream
Definition: proxy.cpp:13
BOOL(CALLBACK * LPFNADDPROPSHEETPAGE)(HPROPSHEETPAGE, LPARAM)
Definition: prsht.h:327
#define REFIID
Definition: guiddef.h:118
const WCHAR * str
_In_ LPCSTR pszDir
Definition: shellapi.h:584
#define IDR_SHELLLINK
Definition: shresdef.h:896
ITEMIDLIST UNALIGNED * LPITEMIDLIST
Definition: shtypes.idl:41
const ITEMIDLIST UNALIGNED * LPCITEMIDLIST
Definition: shtypes.idl:42
static PIXELFORMATDESCRIPTOR pfd
Definition: ssstars.c:67
uint16_t * PWSTR
Definition: typedefs.h:56
int32_t INT_PTR
Definition: typedefs.h:64
char * PSTR
Definition: typedefs.h:51
const uint16_t * PCWSTR
Definition: typedefs.h:57
int32_t INT
Definition: typedefs.h:58
const char * PCSTR
Definition: typedefs.h:52
WORD WORD PSZ PSZ pszFileName
Definition: vdmdbg.h:44
static HMENU hmenu
Definition: win.c:66
_In_ PCCERT_CONTEXT _In_ DWORD dwFlags
Definition: wincrypt.h:1176
_In_ LONG _In_ HWND hwnd
Definition: winddi.h:4023
LONG_PTR LPARAM
Definition: windef.h:208
LONG_PTR LRESULT
Definition: windef.h:209
UINT_PTR WPARAM
Definition: windef.h:207
static void Initialize()
Definition: xlate.c:212
const char * LPCSTR
Definition: xmlstorage.h:183
char * LPSTR
Definition: xmlstorage.h:182
__wchar_t WCHAR
Definition: xmlstorage.h:180
WCHAR * LPWSTR
Definition: xmlstorage.h:184
const WCHAR * LPCWSTR
Definition: xmlstorage.h:185