SipRegisterNotification

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function registers a window, which then receives software-based input panel notifications related to the current input method (IM).

The software-based input panel 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

See Also

Reference

SipEnumIM
SipSetDefaultRect
SipStatus
WM_IM_INFO