CPL_IDNAME

The CPL_IDNAME message is sent to the CPlApplet function to retrieve a Control Panel application's unique ID name string.

Syntax

#define CPL_IDNAME 100
 uAppNum = (UINT) lParam1;
 pszName = (LPWSTR) lParam2;

Parameters

uAppNum
The ID number of the Control Panel application whose ID name is being requested. This number is in the range of zero through one less than the number of Control Panel applications supported by the CPlApplet function.
pszName
A pointer to the string buffer (of length 32) to receive the Control Panel application's ID name as a null-terminated string. The ID name does not need to be the same as the name of the Control Panel application that appears in the Settings application.

Return Values

Zero indicates that the CPlApplet function processed this message successfully. Nonzero indicates otherwise.

Remarks

Handling of this message is required only if the Control Panel option icon exists in a Settings application tab other than the default System tab. When this message is received, the CPlApplet function must copy the ID name of the Control Panel application (specified by uAppNum) into the pszName parameter.

The ID name can be used to retrieve or set information about the Control Panel application via the registry subkey [HKEY_LOCAL_MACHINE\ControlPanel\<ID name>]. The primary data under this subkey is "Group" = dword:1. The possible values for the Group data indicate the tab of the Settings application where the Control Panel option icon exists:

Group value	Settings tab where Control Panel application exists
0	Personal
1 (default value)	System
2	Connections

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: cpl.h