Edit

Share via

SHChangeNotification_Lock function (shlobj_core.h)

  • Article

Locks the shared memory associated with a Shell change notification event.

Syntax

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

Parameters

[in] hChange

Type: HANDLE

A handle to a window received as a wParam in the specified Shell change notification message.

dwProcId

Type: DWORD

The process ID (lParam in the message callback).

[out, optional] pppidl

Type: PIDLIST_ABSOLUTE**

The address of a pointer to a PIDLIST_ABSOLUTE that, when this function returns successfully, receives the list of affected PIDLs.

[out, optional] plEvent

Type: LONG*

A pointer to a LONG value that, when this function returns successfully, receives the Shell change notification ID of the event that took place.

Return value

Type: HANDLE

Returns a handle (HLOCK) to the locked memory. Pass this value to SHChangeNotification_Unlock when finished.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 6.0 or later)
API set ext-ms-win-shell-shell32-l1-2-1 (introduced in Windows 10, version 10.0.10240)