다음을 통해 공유

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를 호출하여 메모리를 해제합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)
DLL Shell32.dll