Função SHRunControlPanel (shlobj.h)

  • Artigo

Abre um item de Painel de Controle.

Nota Não há suporte para essa função a partir do Windows Vista
 

Sintaxe

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

Parâmetros

[in] lpcszCmdLine

Tipo: PCWSTR

Ponteiro para uma cadeia de caracteres que contém a linha de comando que abre o item Painel de Controle. Essa linha de comando inclui pelo menos o nome do arquivo .cpl. Ele também pode conter quaisquer outras informações necessárias, como a página da folha de propriedades dentro do item (por ordinal ou por nome). Para obter mais informações, consulte Executando Painel de Controle itens.

[in, optional] hwndMsgParent

Digite: HWND

O identificador da janela pai, usado para exibir mensagens de erro sobre a abertura do item. Esse valor pode ser NULL.

Valor retornado

Tipo: BOOL

TRUE se o item Painel de Controle foi aberto com êxito; caso contrário, FALSE.

A partir do Windows Vista, essa função sempre retorna FALSE.

Comentários

Se o item de Painel de Controle especificado já estiver em execução, SHRunControlPanel tentará alternar para essa instância em vez de abrir uma nova instância.

Exemplos

As chamadas de exemplo para SHRunControlPanel são mostradas aqui.

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 com suporte Windows XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj.h
DLL Shell32.dll