This function registers a window, which then receives input panel notifications related to the current input method (IM).
At a Glance
| Header file: | Sipapi.h |
| Windows CE versions: | 2.10 and later |
Syntax
BOOL SipRegisterNotification( HWND hWnd );
Parameters
hWnd
[in] Handle of the window to receive 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 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 input panel, and the input panel forwards that information to the window that hWnd identifies.
SipRegisterNotification does not require that the input panel environment be loaded in order to complete successfully. Therefore, a call to SipRegisterNotification does not initialize the input panel environment. The input panel environment is initialized by the first function called that needs a loaded input environment. All input panel functions initialize the input panel environment except SipEnumIM, SipStatus, SipSetDefaultRect, and SipRegisterNotification.