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.
A version of this page is also available for
4/8/2010

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 Value

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 SHGetAppKeyAssocto get the virtual key code for the program button mapped to your application. Then, use a timer and GetAsyncKeyStateto 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.

Requirements

Header aygshell.h
Library aygshell.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also