SipRegisterNotification (Windows CE 5.0)

Send Feedback

This function registers a window, which then receives software-based input panel notifications related to the current input method (IM). The SIP posts a WM_IM_INFO message to the window passed in the call to SipRegisterNotification.

BOOL SipRegisterNotification( HWNDhWnd);

Parameters

  • hWnd
    [in] Handle of the window to receive software-based input panel notifications.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

Remarks

Only one application can register a window to receive software-based input panel notifications. This registration remains in effect until the device is either cold or warm booted. The IM sends information, such as user input, to the software-based input panel, and the software-based input panel forwards that information to the window that hWnd identifies.

SipRegisterNotification does not require that the software-based input panel environment be loaded in order to complete successfully. Therefore, a call to SipRegisterNotification does not initialize the software-based input panel environment. The software-based input panel environment is initialized by the first function called that needs a loaded input environment. All software-based input panel functions initialize the software-based input panel environment except SipEnumIM, SipStatus, SipSetDefaultRect, and SipRegisterNotification.

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Sipapi.h.
Link Library: Coredll.lib.

See Also

SipEnumIM | SipSetDefaultRect | SipStatus | WM_IM_INFO

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.