SipRegisterNotification (Windows Embedded CE 6.0)

1/6/2010

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.

Syntax

BOOL SipRegisterNotification( 
  HWND hWnd
);

Parameters

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

Return Value

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

Header sipapi.h
Library coredll.lib
Windows Embedded CE Windows CE 2.10 and later

See Also

Reference

SipEnumIM
SipSetDefaultRect
SipStatus
WM_IM_INFO

Other Resources

Software-based Input Panel Functions