SHGetAppKeyAssoc (Windows CE 5.0)

Send Feedback

This function determines if a navigational control is mapped to an application.

Syntax

BYTE SHGetAppKeyAssoc(  LPCTSTR ptszApp);

Parameters

  • ptszApp
    [in] Pointer to the null-terminated string that contains the name of the application executable, for example, MyApp.exe.

Return Values

If successful, this function returns the virtual key code of the navigation control associated with the application. It returns 0 to indicate that there is no button mapped to the application.

Remarks

Use this function to add additional features to a mapped navigation control. For example, use SHGetAppKeyAssoc to get the virtual key code for the program button mapped to your application. Then, use a timer and GetAsyncKeyState to determine if the program button is held down for a specified duration. If the button is held down, a new document is created.

This function relies on the data stored in HKEY_LOCAL_MACHINE\Software\Microsoft\Shell\Keys. For information, see Shell Registry Settings.

Requirements

Pocket PC: Pocket PC 2000 and later
OS Versions: Windows CE 3.0 and later
Header: aygshell.h
Library: aygshell.lib

See Also

SHSetAppKeyWndAssoc | GetAsyncKeyState

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.