RegistryCloseNotification

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The function removes a registered request for transient notifications. It also closes the notification handle.

Syntax

HRESULT WINAPI RegistryCloseNotification( 
  HREGNOTIFY hNotify
);

Parameters

  • hNotify
    [in] Handle to a valid notification.

Return Value

The following table shows the return values for this function.

Value Description

S_OK

Registered request for change notification is removed.

E_INVALIDARG

Invalid hNotify.

E_NOT_FOUND

Cannot find notification request in the list.

Remarks

Success indicates that the change notification request was removed. Failure does not cause any change.

RegistryCloseNotification searches for references to hNotify and removes them from the list. The memory associated with hNotify is freed. Pending notifications are lost.

Requirements

Header regext.h
Library aygshell.lib
Windows Embedded CE Windows Embedded CE 6.0 and later
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also

Reference

State and Notifications Broker Functions
State and Notifications Broker Reference

Other Resources

State and Notifications Broker