SipSetInfo

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 SIPINFO structure 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 SipGetInfo to set the input panel information to accommodate the current IM by setting information in the SIPINFO structure such as the input panel window position, size, and state. An application calling SipSetInfo cannot 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 SIPINFO structure beforehand. The following code example shows how to clear the structure.

memset(pSipInfo, 0, sizeof(SIPINFO))

Use the SipGetInfo function 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

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.