CPL_IDNAME

Article
08/28/2006

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 application whose ID name is being requested. This number is in the range of zero through one less than the number of applications supported by the CPlApplet function.
pszName
A pointer to the string buffer (of length 32) to receive the application's ID name as a null-terminated string. The ID name does not need to be the same as the name of the 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 application 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 application (specified by uAppNum) into the pszName parameter.

The ID name can be used to retrieve or set information about the 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 application icon exists:

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

Requirements

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

Share via