 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function sets information including the state of the input panel, the area of the desktop that is not obscured by the input panel, the screen coordinates of the input panel, and application-defined information about the input method (IM) that the input panel is currently using.
BOOL SipSetInfo( SIPINFO * pSipInfo );
Parameters
- pSipInfo
- [in] Pointer to the
SIPINFOstructure that
contains information about the current input panel.
Return Values
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.
Remarks
Use SipGetInfoto set the input panel information to accommodate the current IM by setting information in the SIPINFOstructure such as the input panel window position, size, and state. An application calling SipSetInfocannot request that the input panel window be resized. The size of the input panel window is based on coordination between the input panel and IM.
To prevent undesirable information from being passed to SipSetInfo, clear the SIPINFOstructure beforehand. The following code example shows how to clear the structure.
memset(pSipInfo, 0, sizeof(SIPINFO))
Use the SipGetInfofunction to retrieve information the input panel.
Requirements
Runs On Versions Defined in Include Link to Windows CE OS 2.10 and later Sipapi.h Coresip.lib Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
GetLastError, SipGetInfo, SIPINFO