Share via


SHSetInputContext (Windows CE 5.0)

Send Feedback

For Windows Mobile-based devices, the SHSetInputContext function changes the state of a context feature of an input window. This function allows run-time modification of the contextual properties of an input window.

**Note   **The SHSetInputContext function is not implemented for Windows CE-based devices. It is provided as a stub in the operating system (OS) for application compatibility and will always return E_NOTIMPL.

Syntax

HRESULT SHSetInputContext (HWNDhwnd,DWORDdwFeature,constLPVOIDlpValue);

Parameters

  • hwnd
    [in] Handle to the window whose context feature is being set.
  • dwFeature
    [in] The context feature to change, specified by a value from the SHIC_FEATURE enumeration. For more information, see Remarks.
  • lpValue
    [in] The new value assigned to feature. For more information, see Remarks.

Return Values

  • S_OK
    The function completed successfully.
  • ERROR_INVALID_PARAMETER
    The hwnd parameter was NULL, or the lpValue parameter was NULL when that was not a valid option for the specified dwFeature.
  • ERROR_NOT_SUPPORTED
    The feature specified by the dwFeature parameter was invalid.
  • ERROR_INVALID_DATA
    The value specified by lpValue is not a valid option for the specified dwFeature.

Remarks

The features that can be changed are determined by the SHIC_FEATURE enumeration. One of the enumerators of SHIC_FEATURE must be passed as the dwFeature parameter of SHSetInputContext. Each enumerator has corresponding valid values that can be passed in the lpValue parameter.

For any context feature that is not explicitly defined through this function, the value of that feature is taken from the window's parent window.

Requirements

Pocket PC: Windows Mobile 2003 and later
OS Versions: Windows CE .NET 4.0 and later
Header: aygshell.h
Library: aygshell.lib

See Also

SHGetInputContext

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.