Compartir a través de

Función SHRunControlPanel (shlobj.h)

  • Artículo

Abre un elemento Panel de control.

Nota Esta función no se admite a partir de Windows Vista
 

Sintaxis

BOOL SHRunControlPanel(
  [in]           PCWSTR lpcszCmdLine,
  [in, optional] HWND   hwndMsgParent
);

Parámetros

[in] lpcszCmdLine

Tipo: PCWSTR

Puntero a una cadena que contiene la línea de comandos que abre el elemento Panel de control. Esta línea de comandos incluye al menos el nombre del archivo .cpl. También puede contener cualquier otra información necesaria, como la página de hoja de propiedades dentro del elemento (ya sea por ordinal o por nombre). Para obtener más información, vea Ejecutar elementos de Panel de control.

[in, optional] hwndMsgParent

Tipo: HWND

Identificador de la ventana primaria, que se usa para mostrar mensajes de error sobre la apertura del elemento. Este valor puede ser NULL.

Valor devuelto

Tipo: BOOL

TRUE si el elemento Panel de control se abrió correctamente; de lo contrario, FALSE.

A partir de Windows Vista, esta función siempre devuelve FALSE.

Comentarios

Si el elemento de Panel de control especificado ya se está ejecutando, SHRunControlPanel intenta cambiar a esa instancia en lugar de abrir una nueva instancia.

Ejemplos

Aquí se muestran llamadas de ejemplo a SHRunControlPanel .

SHRunControlPanel(TEXT("timedate.cpl"), hwnd);
SHRunControlPanel(L"appwiz.cpl", NULL);
SHRunControlPanel(L"appwiz.cpl,2", NULL);
SHRunControlPanel("desk.cpl,Settings", hwnd

Requisitos

   
Cliente mínimo compatible Windows XP con SP1 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj.h
Archivo DLL Shell32.dll