SHGetNameFromIDList 함수(shobjidl_core.h)

IDList로 식별된 항목의 표시 이름을 검색합니다.

구문

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

[in] pidl

형식: PCIDLIST_ABSOLUTE

항목을 식별하는 PIDL입니다.

[in] sigdnName

형식: SIGDN

검색할 표시 이름의 형식을 지정하는 SIGDN 열거형의 값입니다.

[out] ppszName

형식: PWSTR*

이 함수가 성공적으로 반환될 때 검색된 표시 이름에 대한 포인터의 주소를 수신하는 값입니다.

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

더 이상 필요하지 않은 경우 ppszName 에서 가리키는 문자열을 해제하는 것은 호출자의 책임입니다. *ppszName에서 CoTaskMemFree를 호출하여 메모리를 해제합니다.