1 out of 1 rated this helpful - Rate this topic

SHChangeNotification_Lock function

Applies to: desktop apps only

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

Syntax

HANDLE SHChangeNotification_Lock(
  __in       HANDLE hChange,
  DWORD dwProcId,
  __out_opt  PIDLIST_ABSOLUTE **pppidl,
  __out_opt  LONG *plEvent
);

Parameters

hChange [in]

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).

pppidl [out, optional]

Type: PIDLIST_ABSOLUTE**

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

plEvent [out, optional]

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

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 6.0 or later)

 

 

Send comments about this topic to Microsoft

Build date: 3/7/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
items sent through shell change notification system don't have full properties
see info on this on the SHChangeNotifyRegister page