CPL_IDNAME
4/8/2010
The CPL_IDNAME message is sent to the CPlApplet function to retrieve a Control Panel application's (CPL's) unique ID name string.
Syntax
#define CPL_IDNAME 100
uAppNum = (UINT) lParam1;
pszName = (LPWSTR) lParam2;
Parameters
- uAppNum
The ID number of the CPL whose ID name is being requested. This number is in the range of zero through one less than the number of CPLs supported by the CPlApplet function.
- pszName
A pointer to the string buffer (of length 32) to receive the CPL's ID name as a null-terminated string. The ID name does not need to be the same as the name of the CPL that appears in the Settings application.
Return Value
Zero indicates that the CPlApplet function processed this message successfully. Nonzero indicates otherwise.
Remarks
Handling of this message is required only if the CPL 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 CPL (specified by uAppNum) into the pszName parameter.
The ID name can be used to retrieve or set information about the CPL 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 CPL icon exists:
| Group value | Settings tab where CPL exists |
|---|---|
0 |
Personal |
1 (default value) |
System |
2 |
Connections |
Requirements
| Header | cpl.h |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Pocket PC 2000 and later |