SHGetAppKeyAssoc

This function determines if a navigational control is mapped to an application on a Palm-size PC.

At a Glance

Header file:	Aygshell.h
Windows CE Versions:	2.01 and later

Syntax

BYTE SHGetAppKeyAssoc(LPCTSTR ptszApp);

Parameters

ptszApp: Pointer to the null-terminated string that contains the name of the application executable, for example, “MyApp.exe.”

Return Values

The virtual key code of the navigation control associated with the application indicates success. Zero indicates that 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.