Функция SHChangeNotification_Lock (shlobj_core.h)

  • Статья

Блокирует общую память, связанную с событием уведомления об изменении оболочки.

Синтаксис

HANDLE SHChangeNotification_Lock(
  [in]            HANDLE           hChange,
                  DWORD            dwProcId,
  [out, optional] PIDLIST_ABSOLUTE **pppidl,
  [out, optional] LONG             *plEvent
);

Параметры

[in] hChange

Тип: HANDLE

Дескриптор окна, полученного в виде wParam в указанном сообщении об изменении оболочки.

dwProcId

Тип: DWORD

Идентификатор процесса (lParam в обратном вызове сообщения).

[out, optional] pppidl

Тип: PIDLIST_ABSOLUTE**

Адрес указателя на PIDLIST_ABSOLUTE, который при успешном возврате этой функции получает список затронутых PIDL.

[out, optional] plEvent

Тип: LONG*

Указатель на значение LONG, которое при успешном возврате этой функции получает идентификатор уведомления об изменении оболочки для события, которое произошло.

Возвращаемое значение

Тип: HANDLE

Возвращает дескриптор (HLOCK) для заблокированной памяти. По завершении передайте это значение в SHChangeNotification_Unlock .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll (версия 6.0 или более поздняя)
Набор API ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)