Cómo registrar elementos de Panel de control DLL
Nota
Las instrucciones de implementación actuales indican que los nuevos elementos de Panel de control deben implementarse como archivos .exe en lugar de .cpl archivos. La siguiente información se incluye principalmente con fines heredados.
Panel de control elementos que se implementan en un archivo DLL que exporta la función CPlApplet tienen requisitos de registro diferentes a .exe archivos. A partir de Windows XP, los nuevos archivos DLL de Panel de control elemento deben instalarse en la carpeta de la aplicación asociada en la carpeta Archivos de programa. No es necesario registrar los elementos almacenados en el directorio System32 con una extensión de .cpl; se muestran automáticamente en el Panel de control. Todos los demás elementos Panel de control que usan CPlApplet deben registrarse de una de estas dos maneras:
- Si el elemento Panel de control está disponible para todos los usuarios, registre la ruta de acceso por equipo agregando un valor de REG_EXPAND_SZ a la subclaveMicrosoft\Windows\CurrentVersion\Panel de control\Cpls de software de HKEY_LOCAL_MACHINE\\, establezca en la ruta de acceso DLL.
- Si el elemento de Panel de control está disponible por usuario, use HKEY_CURRENT_USER como clave raíz en lugar de HKEY_LOCAL_MACHINE.
En los dos ejemplos siguientes se registra el elemento de Panel de control MyCplApp. El archivo DLL se denomina MyCpl.cpl y se encuentra en el directorio de la aplicación MyCorp\MyApp . En este primer ejemplo se muestra el registro por equipo.
Instrucciones
Paso 1:
Agregue esta información al Registro para registrar la existencia del archivo .cpl.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Cpls
MyCpl = [REG_EXPAND_SZ] %ProgramFiles%\MyCorp\MyApp\MyCpl.cpl
Paso 2:
Windows Vista y versiones posteriores: Agregue esta información adicional al Registro para proporcionar un GUID para el elemento de Panel de control.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.AppId
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = {A newly generated GUID}
Al generar un GUID para identificar de forma única el elemento de Panel de control, puede agregar vínculos de tareas al Panel de control. Sin este GUID, no hay ninguna manera de asociar los vínculos de tareas con el elemento Panel de control. Consulte Creating Searchable Task Links for a Panel de control Item (Crear vínculos de tareas que se pueden buscar para un elemento de Panel de control).
Paso 3:
Windows Vista y versiones posteriores: Agregue la siguiente información al Registro para crear un nombre canónico para el elemento.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ApplicationName
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] MyCorporation.MyCpl
Al agregar un nombre canónico, los usuarios pueden iniciar el elemento Panel de control desde una línea de comandos escribiendo control.exe /name MyCorporation.MyCpl. Esto también permite cambiar una implementación de un archivo .cpl a un archivo .exe más adelante, sin necesidad de llamar a programas para realizar cambios, ya que pueden seguir abriendo el elemento a través de su nombre canónico. Para obtener más información sobre los nombres canónicos, vea Ejecución de elementos de Panel de control.
Paso 4:
Windows Vista y versiones posteriores: Agregue la siguiente información al Registro para asignar un elemento de Panel de control a una o varias categorías.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.ControlPanel.Category
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
Windows XP: Agregue la siguiente información al Registro para asignar un elemento de Panel de control a una o varias categorías.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
{305CA226-D286-468e-B848-2B2E8E697B74} 2
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_DWORD] 3
En este ejemplo se asigna el elemento a la categoría 3, que es Red e Internet. Para agregar un elemento a varias categorías, proporcione la lista como un valor de REG_SZ separados por comas, como "3,8". Los valores se pueden proporcionar como decimales o hexadecimales. Tenga en cuenta que la capacidad de agregar un elemento a varias categorías solo es posible en Windows XP Service Pack 2 (SP2) y versiones posteriores. Consulte Asignación de categorías de Panel de control para ver todos los valores posibles.
Paso 5:
Windows Vista y versiones posteriores: Agregue la siguiente información al Registro para crear y apuntar a un archivo XML para contener vínculos de tareas para el elemento. El valor debe ser una ruta de acceso de REG_SZ como se muestra aquí o un módulo y un identificador de recurso (por ejemplo, "C:\Program Files\MyCorp\MyApp\MyApp.exe,-31") si es un recurso incrustado. La ubicación del archivo XML debe especificarse completamente. No puede usar una variable de entorno como %ProgramFiles%.
HKEY_LOCAL_MACHINE
Software
Microsoft
Windows
CurrentVersion
Control Panel
Extended Properties
System.Software.TasksFileUrl
%ProgramFiles%\MyCorp\MyApp\MyCpl.cpl = [REG_SZ] C:\ProgramFiles\MyCorp\MyApp\MyTasks.xml
Para obtener más información sobre los vínculos de tareas y cómo crear el archivo XML para almacenarlos, vea Creating Searchable Task Links for a Panel de control Item.
Temas relacionados