IShellFolder2::GetDefaultColumn 메서드(shobjidl_core.h)

기본 정렬 및 표시 열을 가져옵니다.

구문

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

매개 변수

[in] dwRes

형식:DWORD

예약되어 있습니다. 0으로 설정됩니다.

[out] pSort

형식: ULONG*

기본 정렬 열의 인덱스를 받는 값에 대한 포인터입니다.

[out] pDisplay

형식: ULONG*

기본 표시 열의 인덱스를 받는 값에 대한 포인터입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 COM 오류 값을 반환합니다.

설명

사용자에게 참고 사항

이 메서드에서 반환된 두 열 인덱스는 모두 이 폴더의 폴더 보기를 표시하는 애플리케이션에서 사용하기 위한 것입니다.

pSort로 지정된 열은 폴더의 항목을 정렬하는 데 사용해야 하는 열입니다. 항목 쌍의 정렬 순서를 확인하려면 해당 PID를 CompareID에 전달합니다. CompareIDs의 lParam 매개 변수를 pSort가 가리키는 값으로 설정하여 열을 지정합니다.

보기에 항목을 나타내는 문자열이 하나만 표시되면 pDisplay로 지정된 열에서 가져와야 합니다. 열 인덱스와 항목의 PIDL을 IShellFolder2::GetDetailsOf 에 전달하여 문자열을 검색합니다.

구현자에 대한 참고 사항

이 메서드는 네임스페이스 확장의 폴더 개체 구현의 일부입니다. 일반적으로 폴더 뷰 개체에서 폴더 개체에 Microsoft Windows Explorer 세부 정보 보기의 열을 요청하여 폴더의 항목을 정렬해야 합니다. 예를 들어 트랜잭션 로그를 나타내는 폴더 개체는 pSort 를 트랜잭션 시간을 표시하는 열로 설정할 수 있습니다. 그런 다음 항목은 이름이 아닌 트랜잭션이 일어난 시간에 따라 정렬됩니다.

일부 클라이언트는 이 메서드를 호출하여 트리 뷰에 표시되어야 하는 이름을 사용하여 열의 인덱스를 요청할 수 있습니다. pDisplay를 적절한 열 인덱스로 설정합니다. 그러면 클라이언트는 IShellFolder2::GetDetailsOf를 호출하여 표시 이름을 가져옵니다.

요구 사항

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