IOpenControlPanel::GetPath 메서드(shobjidl_core.h)

지정된 제어판 항목의 경로를 가져옵니다.

구문

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

[in] pszName

형식: LPCWSTR

항목의 정식 이름 또는 GUID에 대한 포인터입니다. 이 값은 NULL일 수 있습니다. 자세한 내용은 비고를 참조하세요. 제어판 항목 정식 이름의 전체 목록은 제어판 항목의 정식 이름을 참조하세요.

[out] pszPath

형식: LPWSTR

이 메서드가 반환될 때 지정된 제어판 항목의 경로를 유니코드 문자열로 포함합니다.

[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}