ReactOS  0.4.15-dev-5130-gc1c1279
changenotify.cpp
Go to the documentation of this file.
1 /*
2  * PROJECT: shell32
3  * LICENSE: LGPL-2.1-or-later (https://spdx.org/licenses/LGPL-2.1-or-later)
4  * PURPOSE: Shell change notification
5  * COPYRIGHT: Copyright 2020 Katayama Hirofumi MZ (katayama.hirofumi.mz@gmail.com)
6  */
7 
8 #include "precomp.h"
9 
11 
13 
14 // This function requests creation of the server window if it doesn't exist yet
15 static HWND
17 {
18  static HWND s_hwndServer = NULL;
19 
20  // use cache if any
21  if (s_hwndServer && IsWindow(s_hwndServer))
22  return s_hwndServer;
23 
24  // get the shell window
25  HWND hwndShell = GetShellWindow();
26  if (hwndShell == NULL)
27  {
28  TRACE("GetShellWindow() returned NULL\n");
29  return NULL;
30  }
31 
32  // Get the window of the notification server that runs in explorer
33  HWND hwndServer = (HWND)SendMessageW(hwndShell, WM_DESKTOP_GET_CNOTIFY_SERVER, bCreate, 0);
34  if (!IsWindow(hwndServer))
35  {
36  ERR("Unable to get server window\n");
37  hwndServer = NULL;
38  }
39 
40  // save and return
41  s_hwndServer = hwndServer;
42  return hwndServer;
43 }
44 
45 // This function will be called from DllMain.DLL_PROCESS_ATTACH.
47 {
49 }
50 
51 // This function will be called from DllMain.DLL_PROCESS_DETACH.
53 {
54  HWND hwndServer = GetNotificationServer(FALSE);
55  if (hwndServer)
58 }
59 
61 // There are two delivery methods: "old delivery method" and "new delivery method".
62 //
63 // The old delivery method creates a broker window in the caller process
64 // for message trampoline. The old delivery method is slow and deprecated.
65 //
66 // The new delivery method is enabled by SHCNRF_NewDelivery flag.
67 // With the new delivery method the server directly sends the delivery message.
68 
69 // This class brokers all notifications that don't have the SHCNRF_NewDelivery flag
71  public CWindowImpl<CChangeNotifyBroker, CWindow, CWorkerTraits>
72 {
73 public:
74  CChangeNotifyBroker(HWND hwndClient, UINT uMsg) :
75  m_hwndClient(hwndClient), m_uMsg(uMsg)
76  {
77  }
78 
79  // Message handlers
81  {
83  }
84 
86  {
87  // The server will destroy this window.
88  // After the window gets destroyed we can delete this broker here.
89  delete this;
90  }
91 
92  DECLARE_WND_CLASS_EX(L"WorkerW", 0, 0)
93 
96  END_MSG_MAP()
97 
98 private:
101 
102  BOOL BrokerNotification(HANDLE hTicket, DWORD dwOwnerPID)
103  {
104  // lock the ticket
105  PIDLIST_ABSOLUTE *ppidl = NULL;
106  LONG lEvent;
107  HANDLE hLock = SHChangeNotification_Lock(hTicket, dwOwnerPID, &ppidl, &lEvent);
108  if (hLock == NULL)
109  {
110  ERR("hLock is NULL\n");
111  return FALSE;
112  }
113 
114  // perform the delivery
115  TRACE("broker notifying: %p, 0x%x, %p, 0x%lx\n",
116  m_hwndClient, m_uMsg, ppidl, lEvent);
118 
119  // unlock the ticket
121  return TRUE;
122  }
123 };
124 
125 // This function creates a notification broker for old method. Used in SHChangeNotifyRegister.
126 static HWND
128 {
129  // Create a new broker. It will be freed when the window gets destroyed
130  CChangeNotifyBroker* pBroker = new CChangeNotifyBroker(hwnd, wMsg);
131  if (pBroker == NULL)
132  {
133  ERR("Out of memory\n");
134  return NULL;
135  }
136 
137  HWND hwndBroker = SHCreateDefaultWorkerWindow();
138  if (hwndBroker == NULL)
139  {
140  ERR("hwndBroker == NULL\n");
141  delete pBroker;
142  return NULL;
143  }
144 
145  pBroker->SubclassWindow(hwndBroker);
146  return hwndBroker;
147 }
148 
149 // This function creates a delivery ticket for shell change nofitication.
150 // Used in SHChangeNotify.
151 static HANDLE
153  DWORD dwOwnerPID, DWORD dwTick)
154 {
155  // pidl1 and pidl2 have variable length. To store them into the delivery ticket,
156  // we have to consider the offsets and the sizes of pidl1 and pidl2.
157  DWORD cbPidl1 = 0, cbPidl2 = 0, ibOffset1 = 0, ibOffset2 = 0;
158  if (pidl1)
159  {
160  cbPidl1 = ILGetSize(pidl1);
161  ibOffset1 = DWORD_ALIGNMENT(sizeof(DELITICKET));
162  }
163  if (pidl2)
164  {
165  cbPidl2 = ILGetSize(pidl2);
166  ibOffset2 = DWORD_ALIGNMENT(ibOffset1 + cbPidl1);
167  }
168 
169  // allocate the delivery ticket
170  DWORD cbSize = ibOffset2 + cbPidl2;
171  HANDLE hTicket = SHAllocShared(NULL, cbSize, dwOwnerPID);
172  if (hTicket == NULL)
173  {
174  ERR("Out of memory\n");
175  return NULL;
176  }
177 
178  // lock the ticket
179  LPDELITICKET pTicket = (LPDELITICKET)SHLockSharedEx(hTicket, dwOwnerPID, TRUE);
180  if (pTicket == NULL)
181  {
182  ERR("SHLockSharedEx failed\n");
183  SHFreeShared(hTicket, dwOwnerPID);
184  return NULL;
185  }
186 
187  // populate the ticket
188  pTicket->dwMagic = DELITICKET_MAGIC;
189  pTicket->wEventId = wEventId;
190  pTicket->uFlags = uFlags;
191  pTicket->ibOffset1 = ibOffset1;
192  pTicket->ibOffset2 = ibOffset2;
193  if (pidl1)
194  memcpy((LPBYTE)pTicket + ibOffset1, pidl1, cbPidl1);
195  if (pidl2)
196  memcpy((LPBYTE)pTicket + ibOffset2, pidl2, cbPidl2);
197 
198  // unlock the ticket and return
199  SHUnlockShared(pTicket);
200  return hTicket;
201 }
202 
203 // This function creates a "handbag" by using a delivery ticket.
204 // The handbag is created in SHChangeNotification_Lock and used in OnBrokerNotification.
205 // hTicket is a ticket handle of a shared memory block and dwOwnerPID is
206 // the owner PID of the ticket.
207 static LPHANDBAG
208 DoGetHandbagFromTicket(HANDLE hTicket, DWORD dwOwnerPID)
209 {
210  // lock and validate the delivery ticket
211  LPDELITICKET pTicket = (LPDELITICKET)SHLockSharedEx(hTicket, dwOwnerPID, FALSE);
212  if (pTicket == NULL || pTicket->dwMagic != DELITICKET_MAGIC)
213  {
214  ERR("pTicket is invalid\n");
215  SHUnlockShared(pTicket);
216  return NULL;
217  }
218 
219  // allocate the handbag
220  LPHANDBAG pHandbag = (LPHANDBAG)LocalAlloc(LMEM_FIXED, sizeof(HANDBAG));
221  if (pHandbag == NULL)
222  {
223  ERR("Out of memory\n");
224  SHUnlockShared(pTicket);
225  return NULL;
226  }
227 
228  // populate the handbag
229  pHandbag->dwMagic = HANDBAG_MAGIC;
230  pHandbag->pTicket = pTicket;
231 
232  pHandbag->pidls[0] = pHandbag->pidls[1] = NULL;
233  if (pTicket->ibOffset1)
234  pHandbag->pidls[0] = (LPITEMIDLIST)((LPBYTE)pTicket + pTicket->ibOffset1);
235  if (pTicket->ibOffset2)
236  pHandbag->pidls[1] = (LPITEMIDLIST)((LPBYTE)pTicket + pTicket->ibOffset2);
237 
238  return pHandbag;
239 }
240 
241 // This function creates a registration entry in SHChangeNotifyRegister function.
242 static HANDLE
243 CreateRegistrationParam(ULONG nRegID, HWND hwnd, UINT wMsg, INT fSources, LONG fEvents,
244  LONG fRecursive, LPCITEMIDLIST pidl, DWORD dwOwnerPID,
245  HWND hwndBroker)
246 {
247  // pidl has variable length. To store it into the registration entry,
248  // we have to consider the length of pidl.
249  DWORD cbPidl = ILGetSize(pidl);
250  DWORD ibPidl = DWORD_ALIGNMENT(sizeof(REGENTRY));
251  DWORD cbSize = ibPidl + cbPidl;
252 
253  // create the registration entry and lock it
254  HANDLE hRegEntry = SHAllocShared(NULL, cbSize, dwOwnerPID);
255  if (hRegEntry == NULL)
256  {
257  ERR("Out of memory\n");
258  return NULL;
259  }
260  LPREGENTRY pRegEntry = (LPREGENTRY)SHLockSharedEx(hRegEntry, dwOwnerPID, TRUE);
261  if (pRegEntry == NULL)
262  {
263  ERR("SHLockSharedEx failed\n");
264  SHFreeShared(hRegEntry, dwOwnerPID);
265  return NULL;
266  }
267 
268  // populate the registration entry
269  pRegEntry->dwMagic = REGENTRY_MAGIC;
270  pRegEntry->cbSize = cbSize;
271  pRegEntry->nRegID = nRegID;
272  pRegEntry->hwnd = hwnd;
273  pRegEntry->uMsg = wMsg;
274  pRegEntry->fSources = fSources;
275  pRegEntry->fEvents = fEvents;
276  pRegEntry->fRecursive = fRecursive;
277  pRegEntry->hwndBroker = hwndBroker;
278  pRegEntry->ibPidl = 0;
279  if (pidl)
280  {
281  pRegEntry->ibPidl = ibPidl;
282  memcpy((LPBYTE)pRegEntry + ibPidl, pidl, cbPidl);
283  }
284 
285  // unlock and return
286  SHUnlockShared(pRegEntry);
287  return hRegEntry;
288 }
289 
290 // This function is the body of SHChangeNotify function.
291 // It creates a delivery ticket and send CN_DELIVER_NOTIFICATION message to
292 // transport the change.
293 static void
295  DWORD dwTick)
296 {
297  // get server window
298  HWND hwndServer = GetNotificationServer(FALSE);
299  if (hwndServer == NULL)
300  return;
301 
302  // the ticket owner is the process of the notification server
303  DWORD pid;
304  GetWindowThreadProcessId(hwndServer, &pid);
305 
306  // create a delivery ticket
307  HANDLE hTicket = CreateNotificationParam(wEventId, uFlags, pidl1, pidl2, pid, dwTick);
308  if (hTicket == NULL)
309  return;
310 
311  TRACE("hTicket: %p, 0x%lx\n", hTicket, pid);
312 
313  // send the ticket by using CN_DELIVER_NOTIFICATION
314  if (pid != GetCurrentProcessId() ||
316  {
317  SendMessageW(hwndServer, CN_DELIVER_NOTIFICATION, (WPARAM)hTicket, pid);
318  }
319  else
320  {
321  SendNotifyMessageW(hwndServer, CN_DELIVER_NOTIFICATION, (WPARAM)hTicket, pid);
322  }
323 }
324 
326 {
327  INT csidl1; // from
328  INT csidl2; // to
333 };
334 
336 {
340 };
341 
342 static VOID DoInitAliasPIDLs(void)
343 {
344  static BOOL s_bInit = FALSE;
345  if (!s_bInit)
346  {
347  for (SIZE_T i = 0; i < _countof(AliasPIDLs); ++i)
348  {
350 
351  SHGetSpecialFolderLocation(NULL, alias->csidl1, &alias->pidl1);
352  SHGetPathFromIDListW(alias->pidl1, alias->szPath1);
353 
354  SHGetSpecialFolderLocation(NULL, alias->csidl2, &alias->pidl2);
355  SHGetPathFromIDListW(alias->pidl2, alias->szPath2);
356  }
357  s_bInit = TRUE;
358  }
359 }
360 
362 {
364 
365  apidls[0] = apidls[1] = NULL;
366 
367  INT k = 0;
368  for (SIZE_T i = 0; i < _countof(AliasPIDLs); ++i)
369  {
370  const ALIAS_PIDL *alias = &AliasPIDLs[i];
371  if (ILIsEqual(pidl, alias->pidl1))
372  {
373  if (alias->csidl1 == alias->csidl2)
374  {
375  apidls[k++] = ILCreateFromPathW(alias->szPath2);
376  }
377  else
378  {
379  apidls[k++] = ILClone(alias->pidl2);
380  }
381  if (k >= 2)
382  break;
383  }
384  }
385 
386  return k > 0;
387 }
388 
389 /*************************************************************************
390  * SHChangeNotifyRegister [SHELL32.2]
391  */
393 SHChangeNotifyRegister(HWND hwnd, INT fSources, LONG wEventMask, UINT uMsg,
394  INT cItems, SHChangeNotifyEntry *lpItems)
395 {
396  HWND hwndServer, hwndBroker = NULL;
397  HANDLE hRegEntry;
398  INT iItem;
399  ULONG nRegID = INVALID_REG_ID;
400  DWORD dwOwnerPID;
401  LPREGENTRY pRegEntry;
402 
403  TRACE("(%p,0x%08x,0x%08x,0x%08x,%d,%p)\n",
404  hwnd, fSources, wEventMask, uMsg, cItems, lpItems);
405 
406  // sanity check
407  if (wEventMask == 0 || cItems <= 0 || cItems > 0x7FFF || lpItems == NULL ||
408  hwnd == NULL || !IsWindow(hwnd))
409  {
410  return INVALID_REG_ID;
411  }
412 
413  // request the window of the server
414  hwndServer = GetNotificationServer(TRUE);
415  if (hwndServer == NULL)
416  return INVALID_REG_ID;
417 
418  // disable recursive interrupt in specific condition
419  if ((fSources & SHCNRF_RecursiveInterrupt) && !(fSources & SHCNRF_InterruptLevel))
420  {
421  fSources &= ~SHCNRF_RecursiveInterrupt;
422  }
423 
424  // if it is old delivery method, then create a broker window
425  if ((fSources & SHCNRF_NewDelivery) == 0)
426  {
427  hwndBroker = hwnd = CreateNotificationBroker(hwnd, uMsg);
428  uMsg = WM_BROKER_NOTIFICATION;
429  }
430 
431  // The owner PID is the process ID of the server
432  GetWindowThreadProcessId(hwndServer, &dwOwnerPID);
433 
435  for (iItem = 0; iItem < cItems; ++iItem)
436  {
437  // create a registration entry
438  hRegEntry = CreateRegistrationParam(nRegID, hwnd, uMsg, fSources, wEventMask,
439  lpItems[iItem].fRecursive, lpItems[iItem].pidl,
440  dwOwnerPID, hwndBroker);
441  if (hRegEntry)
442  {
443  TRACE("CN_REGISTER: hwnd:%p, hRegEntry:%p, pid:0x%lx\n",
444  hwndServer, hRegEntry, dwOwnerPID);
445 
446  // send CN_REGISTER to the server
447  SendMessageW(hwndServer, CN_REGISTER, (WPARAM)hRegEntry, dwOwnerPID);
448 
449  // update nRegID
450  pRegEntry = (LPREGENTRY)SHLockSharedEx(hRegEntry, dwOwnerPID, FALSE);
451  if (pRegEntry)
452  {
453  nRegID = pRegEntry->nRegID;
454  SHUnlockShared(pRegEntry);
455  }
456 
457  // free registration entry
458  SHFreeShared(hRegEntry, dwOwnerPID);
459  }
460 
461  if (nRegID == INVALID_REG_ID)
462  {
463  ERR("Delivery failed\n");
464 
465  if (hwndBroker)
466  {
467  // destroy the broker
468  DestroyWindow(hwndBroker);
469  }
470  break;
471  }
472 
473  // PIDL alias
474  LPITEMIDLIST apidlAlias[2];
475  if (DoGetAliasPIDLs(apidlAlias, lpItems[iItem].pidl))
476  {
477  if (apidlAlias[0])
478  {
479  // create another registration entry
480  hRegEntry = CreateRegistrationParam(nRegID, hwnd, uMsg, fSources, wEventMask,
481  lpItems[iItem].fRecursive, apidlAlias[0],
482  dwOwnerPID, hwndBroker);
483  if (hRegEntry)
484  {
485  TRACE("CN_REGISTER: hwnd:%p, hRegEntry:%p, pid:0x%lx\n",
486  hwndServer, hRegEntry, dwOwnerPID);
487 
488  // send CN_REGISTER to the server
489  SendMessageW(hwndServer, CN_REGISTER, (WPARAM)hRegEntry, dwOwnerPID);
490 
491  // free registration entry
492  SHFreeShared(hRegEntry, dwOwnerPID);
493  }
494  ILFree(apidlAlias[0]);
495  }
496 
497  if (apidlAlias[1])
498  {
499  // create another registration entry
500  hRegEntry = CreateRegistrationParam(nRegID, hwnd, uMsg, fSources, wEventMask,
501  lpItems[iItem].fRecursive, apidlAlias[1],
502  dwOwnerPID, hwndBroker);
503  if (hRegEntry)
504  {
505  TRACE("CN_REGISTER: hwnd:%p, hRegEntry:%p, pid:0x%lx\n",
506  hwndServer, hRegEntry, dwOwnerPID);
507 
508  // send CN_REGISTER to the server
509  SendMessageW(hwndServer, CN_REGISTER, (WPARAM)hRegEntry, dwOwnerPID);
510 
511  // free registration entry
512  SHFreeShared(hRegEntry, dwOwnerPID);
513  }
514  ILFree(apidlAlias[1]);
515  }
516  }
517  }
519 
520  return nRegID;
521 }
522 
523 /*************************************************************************
524  * SHChangeNotifyDeregister [SHELL32.4]
525  */
528 {
529  TRACE("(0x%08x)\n", hNotify);
530 
531  // get the server window
532  HWND hwndServer = GetNotificationServer(FALSE);
533  if (hwndServer == NULL)
534  return FALSE;
535 
536  // send CN_UNREGISTER message and try to unregister
537  BOOL ret = (BOOL)SendMessageW(hwndServer, CN_UNREGISTER, hNotify, 0);
538  if (!ret)
539  ERR("CN_UNREGISTER failed\n");
540 
541  return ret;
542 }
543 
544 /*************************************************************************
545  * SHChangeNotifyUpdateEntryList [SHELL32.5]
546  */
549  DWORD unknown3, DWORD unknown4)
550 {
551  FIXME("(0x%08x, 0x%08x, 0x%08x, 0x%08x)\n",
552  unknown1, unknown2, unknown3, unknown4);
553  return TRUE;
554 }
555 
556 /* for dumping events */
558 {
559  if (event == SHCNE_ALLEVENTS)
560  return "SHCNE_ALLEVENTS";
561 #define DUMPEV(x) ,( event & SHCNE_##x )? #x " " : ""
562  return wine_dbg_sprintf( "%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s%s"
563  DUMPEV(RENAMEITEM)
564  DUMPEV(CREATE)
565  DUMPEV(DELETE)
566  DUMPEV(MKDIR)
567  DUMPEV(RMDIR)
568  DUMPEV(MEDIAINSERTED)
569  DUMPEV(MEDIAREMOVED)
570  DUMPEV(DRIVEREMOVED)
571  DUMPEV(DRIVEADD)
572  DUMPEV(NETSHARE)
573  DUMPEV(NETUNSHARE)
574  DUMPEV(ATTRIBUTES)
575  DUMPEV(UPDATEDIR)
576  DUMPEV(UPDATEITEM)
577  DUMPEV(SERVERDISCONNECT)
578  DUMPEV(UPDATEIMAGE)
579  DUMPEV(DRIVEADDGUI)
580  DUMPEV(RENAMEFOLDER)
581  DUMPEV(FREESPACE)
582  DUMPEV(EXTENDED_EVENT)
583  DUMPEV(ASSOCCHANGED)
584  DUMPEV(INTERRUPT)
585  );
586 #undef DUMPEV
587 }
588 
589 /*************************************************************************
590  * SHChangeRegistrationReceive [SHELL32.646]
591  */
593 SHChangeRegistrationReceive(LPVOID lpUnknown1, DWORD dwUnknown2)
594 {
595  FIXME("SHChangeRegistrationReceive() stub\n");
596  return FALSE;
597 }
598 
601  LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2, DWORD dwTick)
602 {
603  // TODO: Queueing notifications
604  CreateNotificationParamAndSend(lEvent, uFlags, pidl1, pidl2, dwTick);
605 }
606 
607 /*************************************************************************
608  * SHChangeNotifyReceive [SHELL32.643]
609  */
612 {
614 }
615 
618 {
619  SHChangeNotifyReceiveEx(lEvent, uFlags, pidl1, pidl2, dwTick);
620 }
621 
622 /*************************************************************************
623  * SHChangeNotify [SHELL32.@]
624  */
625 EXTERN_C void WINAPI
626 SHChangeNotify(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
627 {
628  LPITEMIDLIST pidl1 = NULL, pidl2 = NULL, pidlTemp1 = NULL, pidlTemp2 = NULL;
629  DWORD dwTick = GetTickCount();
630  WCHAR szPath1[MAX_PATH], szPath2[MAX_PATH];
631  LPWSTR psz1, psz2;
632  TRACE("(0x%08x,0x%08x,%p,%p)\n", wEventId, uFlags, dwItem1, dwItem2);
633 
634  switch (uFlags & SHCNF_TYPE)
635  {
636  case SHCNF_IDLIST:
637  pidl1 = (LPITEMIDLIST)dwItem1;
638  pidl2 = (LPITEMIDLIST)dwItem2;
639  break;
640 
641  case SHCNF_PATHA:
642  psz1 = psz2 = NULL;
643  if (dwItem1)
644  {
645  SHAnsiToUnicode((LPCSTR)dwItem1, szPath1, _countof(szPath1));
646  psz1 = szPath1;
647  }
648  if (dwItem2)
649  {
650  SHAnsiToUnicode((LPCSTR)dwItem2, szPath2, _countof(szPath2));
651  psz2 = szPath2;
652  }
653  uFlags &= ~SHCNF_TYPE;
654  uFlags |= SHCNF_PATHW;
655  SHChangeNotify(wEventId, uFlags, psz1, psz2);
656  return;
657 
658  case SHCNF_PATHW:
659  if (dwItem1)
660  {
661  pidl1 = pidlTemp1 = SHSimpleIDListFromPathW((LPCWSTR)dwItem1);
662  }
663  if (dwItem2)
664  {
665  pidl2 = pidlTemp2 = SHSimpleIDListFromPathW((LPCWSTR)dwItem2);
666  }
667  break;
668 
669  case SHCNF_PRINTERA:
670  case SHCNF_PRINTERW:
671  FIXME("SHChangeNotify with (uFlags & SHCNF_PRINTER)\n");
672  return;
673 
674  default:
675  FIXME("unknown type %08x\n", uFlags & SHCNF_TYPE);
676  return;
677  }
678 
679  if (wEventId == 0 || (wEventId & SHCNE_ASSOCCHANGED) || pidl1 != NULL)
680  {
681  TRACE("notifying event %s(%x)\n", DumpEvent(wEventId), wEventId);
682  SHChangeNotifyTransmit(wEventId, uFlags, pidl1, pidl2, dwTick);
683  }
684 
685  if (pidlTemp1)
686  ILFree(pidlTemp1);
687  if (pidlTemp2)
688  ILFree(pidlTemp2);
689 }
690 
691 /*************************************************************************
692  * NTSHChangeNotifyRegister [SHELL32.640]
693  */
696  INT count, SHChangeNotifyEntry *idlist)
697 {
699  fEvents, msg, count, idlist);
700 }
701 
702 /*************************************************************************
703  * SHChangeNotification_Lock [SHELL32.644]
704  */
706 SHChangeNotification_Lock(HANDLE hTicket, DWORD dwOwnerPID, LPITEMIDLIST **lppidls,
707  LPLONG lpwEventId)
708 {
709  TRACE("%p %08x %p %p\n", hTicket, dwOwnerPID, lppidls, lpwEventId);
710 
711  // create a handbag from the ticket
712  LPHANDBAG pHandbag = DoGetHandbagFromTicket(hTicket, dwOwnerPID);
713  if (pHandbag == NULL || pHandbag->dwMagic != HANDBAG_MAGIC)
714  {
715  ERR("pHandbag is invalid\n");
716  return NULL;
717  }
718 
719  // populate parameters from the handbag
720  if (lppidls)
721  *lppidls = pHandbag->pidls;
722  if (lpwEventId)
723  *lpwEventId = (pHandbag->pTicket->wEventId & ~SHCNE_INTERRUPT);
724 
725  // return the handbag
726  return pHandbag;
727 }
728 
729 /*************************************************************************
730  * SHChangeNotification_Unlock [SHELL32.645]
731  */
734 {
735  TRACE("%p\n", hLock);
736 
737  // validate the handbag
738  LPHANDBAG pHandbag = (LPHANDBAG)hLock;
739  if (pHandbag == NULL || pHandbag->dwMagic != HANDBAG_MAGIC)
740  {
741  ERR("pHandbag is invalid\n");
742  return FALSE;
743  }
744 
745  // free the handbag
746  BOOL ret = SHUnlockShared(pHandbag->pTicket);
747  LocalFree(hLock);
748  return ret;
749 }
750 
751 /*************************************************************************
752  * NTSHChangeNotifyDeregister [SHELL32.641]
753  */
756 {
757  FIXME("(0x%08x):semi stub.\n", hNotify);
758  return SHChangeNotifyDeregister(hNotify);
759 }
760 
761 /*************************************************************************
762  * SHChangeNotifySuspendResume [SHELL32.277]
763  */
765 WINAPI
767  LPITEMIDLIST pidl,
768  BOOL bRecursive,
770 {
771  FIXME("SHChangeNotifySuspendResume() stub\n");
772  return FALSE;
773 }
#define DUMPEV(x)
#define HANDBAG_MAGIC
static HWND GetNotificationServer(BOOL bCreate)
static HWND CreateNotificationBroker(HWND hwnd, UINT wMsg)
_In_ ULONG_PTR _In_ ULONG _Out_ ULONG_PTR * pid
Definition: winddi.h:3835
HWND WINAPI GetShellWindow(VOID)
Definition: desktop.c:651
PVOID WINAPI SHLockSharedEx(HANDLE hData, DWORD dwProcessId, BOOL bWriteAccess)
void WINAPI ILFree(LPITEMIDLIST pidl)
Definition: pidl.c:925
static ALIAS_PIDL AliasPIDLs[]
EXTERN_C DWORD WINAPI NTSHChangeNotifyDeregister(ULONG hNotify)
EXTERN_C void FreeChangeNotifications(void)
DWORD WINAPI GetWindowThreadProcessId(HWND hWnd, PDWORD lpdwProcessId)
CRITICAL_SECTION SHELL32_ChangenotifyCS
const WCHAR * LPCWSTR
Definition: xmlstorage.h:185
BOOL WINAPI IsWindow(_In_opt_ HWND)
EXTERN_C void InitChangeNotifications(void)
EXTERN_C BOOL WINAPI SHChangeNotification_Unlock(HANDLE hLock)
#define CSIDL_COMMON_DESKTOPDIRECTORY
Definition: shlobj.h:2036
#define WM_DESKTOP_GET_CNOTIFY_SERVER
#define TRUE
Definition: types.h:120
#define CSIDL_DESKTOP
Definition: shlobj.h:2012
GLuint GLuint GLsizei count
Definition: gl.h:1545
const ITEMIDLIST UNALIGNED * LPCITEMIDLIST
Definition: shtypes.idl:42
BOOL WINAPI SHGetPathFromIDListW(LPCITEMIDLIST pidl, LPWSTR pszPath)
Definition: pidl.c:1294
#define DECLARE_WND_CLASS_EX(WndClassName, style, bkgnd)
Definition: atlwin.h:1998
#define SHCNE_INTERRUPT
Definition: shlobj.h:1754
DWORD WINAPI GetTickCount(VOID)
Definition: time.c:455
HANDLE HWND
Definition: compat.h:19
#define DELITICKET_MAGIC
void OnFinalMessage(HWND)
#define SHCNRF_RecursiveInterrupt
Definition: shlobj.h:1776
BOOL WINAPI ILIsEqual(LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
Definition: pidl.c:535
UINT_PTR WPARAM
Definition: windef.h:207
#define REGENTRY_MAGIC
UINT uFlags
Definition: api.c:59
EXTERN_C BOOL WINAPI SHChangeNotifySuspendResume(BOOL bSuspend, LPITEMIDLIST pidl, BOOL bRecursive, DWORD dwReserved)
void WINAPI EnterCriticalSection(LPCRITICAL_SECTION)
#define BOOL
Definition: nt_native.h:43
BOOL WINAPI DestroyWindow(_In_ HWND)
int32_t INT
Definition: typedefs.h:58
WPARAM wParam
Definition: combotst.c:138
const char * wine_dbg_sprintf(const char *format,...)
Definition: compat.c:296
#define INVALID_REG_ID
LPITEMIDLIST pidl2
#define L(x)
Definition: ntvdm.h:50
BOOL SubclassWindow(HWND hWnd)
Definition: atlwin.h:1546
unsigned char * LPBYTE
Definition: typedefs.h:53
BOOL WINAPI SendNotifyMessageW(_In_ HWND, _In_ UINT, _In_ WPARAM, _In_ LPARAM)
#define CN_REGISTER
#define FALSE
Definition: types.h:117
_In_ HANDLE _In_ DWORD _In_ DWORD _Inout_opt_ LPOVERLAPPED _In_opt_ LPTRANSMIT_FILE_BUFFERS _In_ DWORD dwReserved
Definition: mswsock.h:90
unsigned int BOOL
Definition: ntddk_ex.h:94
#define SHCNE_ALLEVENTS
Definition: shlobj.h:1753
long LONG
Definition: pedump.c:60
#define FIXME(fmt,...)
Definition: debug.h:111
EXTERN_C ULONG WINAPI NTSHChangeNotifyRegister(HWND hwnd, INT fSources, LONG fEvents, UINT msg, INT count, SHChangeNotifyEntry *idlist)
LPDELITICKET pTicket
static LPCSTR DumpEvent(LONG event)
#define SHCNRF_InterruptLevel
Definition: shlobj.h:1774
VOID WINAPI InitializeCriticalSection(OUT LPCRITICAL_SECTION lpCriticalSection)
Definition: synch.c:751
EXTERN_C BOOL WINAPI SHChangeNotifyUpdateEntryList(DWORD unknown1, DWORD unknown2, DWORD unknown3, DWORD unknown4)
#define CN_UNREGISTER_PROCESS
LONG_PTR LPARAM
Definition: windef.h:208
LPITEMIDLIST pidls[2]
WCHAR szPath2[MAX_PATH]
const char * LPCSTR
Definition: xmlstorage.h:183
static void CreateNotificationParamAndSend(LONG wEventId, UINT uFlags, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2, DWORD dwTick)
LRESULT OnBrokerNotification(UINT uMsg, WPARAM wParam, LPARAM lParam, BOOL &bHandled)
#define LMEM_FIXED
Definition: winbase.h:365
#define SHCNF_PRINTERW
Definition: shlobj.h:1765
#define TRACE(s)
Definition: solgame.cpp:4
CChangeNotifyBroker(HWND hwndClient, UINT uMsg)
HANDLE WINAPI SHAllocShared(LPCVOID lpvData, DWORD dwSize, DWORD dwProcId)
Definition: ordinal.c:162
LPITEMIDLIST WINAPI SHSimpleIDListFromPathW(LPCWSTR lpszPath)
Definition: pidl.c:1120
__wchar_t WCHAR
Definition: xmlstorage.h:180
void WINAPI DeleteCriticalSection(PCRITICAL_SECTION)
LPITEMIDLIST pidl1
HRESULT WINAPI SHGetSpecialFolderLocation(HWND hwndOwner, INT nFolder, LPITEMIDLIST *ppidl)
Definition: shellpath.c:2984
#define END_MSG_MAP()
Definition: atlwin.h:1911
EXTERN_C BOOL WINAPI SHChangeNotifyDeregister(ULONG hNotify)
#define _countof(array)
Definition: sndvol32.h:68
#define MKDIR(d)
Definition: compat.h:23
#define SHCNF_IDLIST
Definition: shlobj.h:1760
#define MAX_PATH
Definition: compat.h:34
#define WINAPI
Definition: msvc.h:6
DWORD WINAPI SHAnsiToUnicode(LPCSTR lpSrcStr, LPWSTR lpDstStr, int iLen)
Definition: string.c:2659
unsigned long DWORD
Definition: ntddk_ex.h:95
#define WM_BROKER_NOTIFICATION
#define SHCNF_PRINTERA
Definition: shlobj.h:1762
BOOL WINAPI SHFreeShared(HANDLE hShared, DWORD dwProcId)
Definition: ordinal.c:308
int ret
EXTERN_C void WINAPI SHChangeNotify(LONG wEventId, UINT uFlags, LPCVOID dwItem1, LPCVOID dwItem2)
#define SHCNF_TYPE
Definition: shlobj.h:1766
#define SHCNF_FLUSH
Definition: shlobj.h:1767
EXTERN_C BOOL WINAPI SHChangeRegistrationReceive(LPVOID lpUnknown1, DWORD dwUnknown2)
struct HANDBAG * LPHANDBAG
EXTERN_C VOID WINAPI SHChangeNotifyTransmit(LONG lEvent, UINT uFlags, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2, DWORD dwTick)
HANDLE lEvent
Definition: tftpd.cpp:56
#define memcpy(s1, s2, n)
Definition: mkisofs.h:878
#define CN_DELIVER_NOTIFICATION
EXTERN_C VOID WINAPI SHChangeNotifyReceive(LONG lEvent, UINT uFlags, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2)
struct _cl_event * event
Definition: glext.h:7739
static VOID DoInitAliasPIDLs(void)
const WCHAR * alias
Definition: main.c:67
#define SHCNF_PATHW
Definition: shlobj.h:1764
#define SHCNRF_NewDelivery
Definition: shlobj.h:1777
#define ERR(fmt,...)
Definition: debug.h:110
#define CN_UNREGISTER
ULONG_PTR SIZE_T
Definition: typedefs.h:80
WCHAR szPath1[MAX_PATH]
int32_t * LPLONG
Definition: typedefs.h:58
_In_ int _In_ BOOL bCreate
Definition: shlobj.h:1444
GLsizei GLenum const GLvoid GLsizei GLenum GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLint GLint GLint GLshort GLshort GLshort GLubyte GLubyte GLubyte GLuint GLuint GLuint GLushort GLushort GLushort GLbyte GLbyte GLbyte GLbyte GLdouble GLdouble GLdouble GLdouble GLfloat GLfloat GLfloat GLfloat GLint GLint GLint GLint GLshort GLshort GLshort GLshort GLubyte GLubyte GLubyte GLubyte GLuint GLuint GLuint GLuint GLushort GLushort GLushort GLushort GLboolean const GLdouble const GLfloat const GLint const GLshort const GLbyte const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLdouble const GLfloat const GLfloat const GLint const GLint const GLshort const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort const GLdouble const GLfloat const GLint const GLshort GLenum GLenum GLenum GLfloat GLenum GLint GLenum GLenum GLenum GLfloat GLenum GLenum GLint GLenum GLfloat GLenum GLint GLint GLushort GLenum GLenum GLfloat GLenum GLenum GLint GLfloat const GLubyte GLenum GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLint GLint GLsizei GLsizei GLint GLenum GLenum const GLvoid GLenum GLenum const GLfloat GLenum GLenum const GLint GLenum GLenum const GLdouble GLenum GLenum const GLfloat GLenum GLenum const GLint GLsizei GLuint GLfloat GLuint GLbitfield GLfloat GLint GLuint GLboolean GLenum GLfloat GLenum GLbitfield GLenum GLfloat GLfloat GLint GLint const GLfloat GLenum GLfloat GLfloat GLint GLint GLfloat GLfloat GLint GLint const GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat GLint GLfloat GLfloat const GLdouble const GLfloat const GLdouble const GLfloat GLint i
Definition: glfuncs.h:248
HLOCAL NTAPI LocalFree(HLOCAL hMem)
Definition: heapmem.c:1577
LPITEMIDLIST WINAPI ILClone(LPCITEMIDLIST pidl)
Definition: pidl.c:228
LRESULT WINAPI SendMessageW(_In_ HWND, _In_ UINT, _In_ WPARAM, _In_ LPARAM)
unsigned int UINT
Definition: ndis.h:50
#define NULL
Definition: types.h:112
EXTERN_C HANDLE WINAPI SHChangeNotification_Lock(HANDLE hTicket, DWORD dwOwnerPID, LPITEMIDLIST **lppidls, LPLONG lpwEventId)
static LPHANDBAG DoGetHandbagFromTicket(HANDLE hTicket, DWORD dwOwnerPID)
struct DELITICKET * LPDELITICKET
#define ILGetSize
Definition: shellclasses.h:638
#define BEGIN_MSG_MAP(theClass)
Definition: atlwin.h:1892
static HANDLE CreateRegistrationParam(ULONG nRegID, HWND hwnd, UINT wMsg, INT fSources, LONG fEvents, LONG fRecursive, LPCITEMIDLIST pidl, DWORD dwOwnerPID, HWND hwndBroker)
#define MESSAGE_HANDLER(msg, func)
Definition: atlwin.h:1920
#define msg(x)
Definition: auth_time.c:54
#define CSIDL_PERSONAL
Definition: shlobj.h:2017
CONST void * LPCVOID
Definition: windef.h:191
EXTERN_C ULONG WINAPI SHChangeNotifyRegister(HWND hwnd, INT fSources, LONG wEventMask, UINT uMsg, INT cItems, SHChangeNotifyEntry *lpItems)
BOOL BrokerNotification(HANDLE hTicket, DWORD dwOwnerPID)
BOOL WINAPI SHUnlockShared(LPVOID lpView)
Definition: ordinal.c:288
unsigned int ULONG
Definition: retypes.h:1
HLOCAL NTAPI LocalAlloc(UINT uFlags, SIZE_T dwBytes)
Definition: heapmem.c:1373
#define CSIDL_DESKTOPDIRECTORY
Definition: shlobj.h:2027
void WINAPI LeaveCriticalSection(LPCRITICAL_SECTION)
LPITEMIDLIST WINAPI ILCreateFromPathW(LPCWSTR path)
Definition: pidl.c:982
WCHAR * LPWSTR
Definition: xmlstorage.h:184
LONG_PTR LRESULT
Definition: windef.h:209
_In_ LONG _In_ HWND hwnd
Definition: winddi.h:4022
WINE_DEFAULT_DEBUG_CHANNEL(shcn)
#define EXTERN_C
Definition: basetyps.h:12
ITEMIDLIST UNALIGNED * LPITEMIDLIST
Definition: shtypes.idl:41
EXTERN_C VOID WINAPI SHChangeNotifyReceiveEx(LONG lEvent, UINT uFlags, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2, DWORD dwTick)
LPARAM lParam
Definition: combotst.c:139
HWND SHCreateDefaultWorkerWindow(VOID)
int k
Definition: mpi.c:3369
struct REGENTRY * LPREGENTRY
#define DWORD_ALIGNMENT(offset)
#define SHCNF_PATHA
Definition: shlobj.h:1761
static BOOL DoGetAliasPIDLs(LPITEMIDLIST apidls[2], PCIDLIST_ABSOLUTE pidl)
#define SHCNF_FLUSHNOWAIT
Definition: shlobj.h:1768
DWORD WINAPI GetCurrentProcessId(VOID)
Definition: proc.c:1158
#define DELETE
Definition: nt_native.h:57
static HANDLE CreateNotificationParam(LONG wEventId, UINT uFlags, LPCITEMIDLIST pidl1, LPCITEMIDLIST pidl2, DWORD dwOwnerPID, DWORD dwTick)
#define SHCNE_ASSOCCHANGED
Definition: shlobj.h:1750