Método IOpenControlPanel::GetPath (shobjidl_core.h)

Obtém o caminho de um item de Painel de Controle especificado.

Sintaxe

HRESULT GetPath(
  [in]  LPCWSTR pszName,
  [out] LPWSTR  pszPath,
  [in]  UINT    cchPath
);

Parâmetros

[in] pszName

Tipo: LPCWSTR

Um ponteiro para o nome canônico do item ou seu GUID. Esse valor pode ser NULL. Consulte Comentários para obter mais detalhes. Para obter uma lista completa de nomes canônicos de Painel de Controle item, consulte Nomes canônicos de itens de Painel de Controle.

[out] pszPath

Tipo: LPWSTR

Quando esse método retorna, contém o caminho do item de Painel de Controle especificado como uma cadeia de caracteres Unicode.

[in] cchPath

Tipo: UINT

O tamanho do buffer apontado por pszPath, em WCHARs.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Se pszName apontar para o nome canônico ou GUID do item, o caminho retornado estará em uma dessas duas formas, dependendo do modo de exibição de Painel de Controle mais recente (Modo de Exibição Clássico ou Exibição de Categoria):

::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}

Se pszName for NULL , um desses dois valores será retornado:

::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)

Confira também

Desenvolvendo para o Painel de Controle

IOpenControlPanel