IOpenControlPanel::GetPath 方法 (shobjidl_core.h)

获取指定控制面板项的路径。

语法

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

参数

[in] pszName

类型: LPCWSTR

指向项的规范名称或其 GUID 的指针。 此值可以为 NULL。 有关更多详细信息,请参阅“备注”。 有关控制面板项规范名称的完整列表,请参阅控制面板项的规范名称

[out] pszPath

类型: LPWSTR

此方法返回时,将指定控制面板项的路径作为 Unicode 字符串包含在内。

[in] cchPath

类型: UINT

pszPath 指向的缓冲区的大小(以 WCHAR 表示)。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

如果 pszName 指向项的规范名称或 GUID,则返回的路径采用以下两种形式之一,具体取决于最新控制面板视图 (经典视图或类别视图) :

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

如果 pszNameNULL ,则返回以下两个值之一:

::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

针对控制面板进行开发

IOpenControlPanel