IShellDetails::GetDetailsOf 메서드(shlobj_core.h)

Shell 폴더의 항목에 대한 자세한 정보를 가져옵니다.

구문

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

매개 변수

[in, optional] pidl

형식: PCUITEMID_CHILD

정보를 요청하는 항목의 PIDL입니다. 이 매개 변수를 NULL로 설정하면 iColumn에서 지정한 정보 필드의 제목이 pDetails가 가리키는 SHELLDETAILS 구조체에 반환됩니다.

iColumn

형식: UINT

원하는 정보 필드의 인덱스(0부터 시작)입니다. Windows Explorer 세부 정보 보기에 표시되는 정보의 열 번호와 동일합니다.

[out] pDetails

형식: SHELLDETAILS*

세부 정보가 포함된 SHELLDETAILS 구조체에 대한 포인터입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환합니다. iColumn이 폴더에서 지원하는 열 수를 초과하면 E_FAIL 반환합니다. 그렇지 않으면 표준 COM 오류 코드를 반환합니다.

설명

이 메서드는 셸 버전 5.0 이상용 IShellFolder2 메서드로 대체되었습니다.

IShellDetails::GetDetailsOf 메서드는 셸 폴더의 Windows Explorer 세부 정보 보기에 표시되는 정보에 대한 액세스를 제공합니다. 세부 정보 보기에 표시되는 열 번호, 열 제목 및 항목 정보는 IShellDetails::GetDetailsOf에서 반환한 열 번호와 동일합니다.

사용 가능한 정보 필드와 해당 열 번호는 특정 폴더에 따라 달라집니다. 사용 가능한 필드를 열거하려면 iColumn 값을 늘리기 위해 pidl이 NULL로 설정된 IShellDetails::GetDetailsOf를 호출합니다. 이 방법은 각 열 인덱스와 연결된 제목을 제공합니다. iColumn이 폴더에서 지원하는 열 수를 초과하면 IShellDetails::GetDetailsOf는 E_FAIL 반환합니다. 이러한 타이틀은 지역화할 수 있으며 모든 로캘에 대해 동일하지 않을 수 있습니다.

파일 시스템 폴더에는 큰 표준 정보 필드 집합이 있습니다. 처음 네 개의 필드는 모든 파일 시스템 폴더에 대한 표준입니다.

열 인덱스	열 제목
0	Name
1	크기
2	Type
3	수정한 날짜

 

파일 시스템 폴더는 여러 추가 필드를 지원할 수 있습니다. 그러나 이렇게 할 필요는 없으며 이러한 필드에 할당된 열 인덱스는 다를 수 있습니다.

각 가상 폴더에는 고유한 정보 필드 집합이 있습니다. 일반적으로 항목의 표시 이름은 열 0에 있지만 사용 가능한 필드의 순서와 콘텐츠는 특정 폴더 개체의 구현에 따라 달라집니다.

구현자에 대한 참고 사항

폴더 개체는 이 인터페이스 대신 IShellFolder2 를 구현해야 합니다.

요구 사항

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