Método IOpenControlPanel::GetPath (shobjidl_core.h)
Obtiene la ruta de acceso de un elemento de Panel de control especificado.
Sintaxis
HRESULT GetPath(
[in] LPCWSTR pszName,
[out] LPWSTR pszPath,
[in] UINT cchPath
);
Parámetros
[in] pszName
Tipo: LPCWSTR
Puntero al nombre canónico del elemento o su GUID. Este valor puede ser NULL. Consulte Comentarios para obtener más detalles. Para obtener una lista completa de los nombres canónicos de Panel de control elemento, vea Nombres canónicos de Panel de control elementos.
[out] pszPath
Tipo: LPWSTR
Cuando este método vuelve, contiene la ruta de acceso del elemento Panel de control especificado como una cadena Unicode.
[in] cchPath
Tipo: UINT
Tamaño del búfer al que apunta pszPath, en WCHAR.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Si pszName apunta al nombre canónico o GUID del elemento, la ruta de acceso devuelta se encuentra en uno de estos dos formularios, según la vista de Panel de control más reciente (Vista clásica o Vista categoría):
::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}
Si pszName es NULL , se devuelve uno de estos dos valores:
::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |