SHChangeNotifyDeregister function (shlobj_core.h)

Unregisters the client's window process from receiving SHChangeNotify messages.

Syntax

BOOL SHChangeNotifyDeregister(
  ULONG ulID
);

Parameters

ulID

Type: ULONG

A value of type ULONG that specifies the registration ID returned by SHChangeNotifyRegister.

Return value

Type: BOOL

Returns TRUE if the specified client was found and removed; otherwise FALSE.

Remarks

See the Change Notify Watcher Sample in the Windows Software Development Kit (SDK) for a full example that demonstrates the use of this function.

The NTSHChangeNotifyDeregister function, which is no longer available for use as of Windows Vista, was equivalent to SHChangeNotifyDeregister.

Requirements

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