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)