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}
如果 pszName 为 NULL ,则返回以下两个值之一:
::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | shobjidl_core.h (包括 Shobjidl.h) |