SipRegisterNotification
A version of this page is also available for
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
| Header | sipapi.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 2.10 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |