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

WCHAR 中 pszPath 所指向的緩衝區大小。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

如果 pszName 指向項目的標準名稱或 GUID，則傳回的路徑會以這兩種形式之一，視最新的控制台檢視 (傳統檢視或類別檢視) 而定：

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

如果 pszName 為 NULL ，則會傳回這兩個值的其中一個：

::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}