Expand Minimize
1 out of 1 rated this helpful - Rate this topic

SHChangeNotification_Lock function

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 [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 6.0 or later)

 

 

Send comments about this topic to Microsoft

Build date: 11/28/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

ADD
© 2013 Microsoft. All rights reserved.