IColumnProvider::GetItemData 메서드(shlobj.h)

지정된 파일에 대한 열 데이터를 요청합니다.

구문

HRESULT GetItemData(
  [in]  LPCSHCOLUMNID   pscid,
  [in]  LPCSHCOLUMNDATA pscd,
  [out] VARIANT         *pvarData
);

매개 변수

[in] pscid

형식: LPCSHCOLUMNID

열을 식별하는 SHCOLUMNID 구조체입니다.

[in] pscd

형식: LPCSHCOLUMNDATA

파일을 지정하는 SHCOLUMNDATA 구조체입니다.

[out] pvarData

형식: VARIANT*

pscid로 지정된 열에 속하는 pscd로 지정된 파일의 데이터가 있는 VARIANT에 대한 포인터입니다. 파일이 열 공급자가 지원하는 클래스의 멤버인 경우 이 값을 설정합니다.

반환 값

형식: HRESULT

파일 데이터가 반환되면 S_OK 반환하고, 열 공급자가 파일을 지원하지 않고 데이터가 반환되지 않는지 S_FALSE, 그렇지 않으면 COM 오류 값을 반환합니다.

설명

이 메서드는 지정된 열에 표시할 파일의 데이터를 검색하기 위해 호출됩니다. 스레드로부터 안전해야 합니다.

이 메서드는 Windows Explorer 표시 하는 모든 파일에 대 한 호출 됩니다., 비록 그들 중 많은 특정 열 공급자에 의해 지원 되지 않습니다. 성능을 향상시키려면 먼저 pscd가 가리키는 구조체의 pwszExt 멤버를 검사 열 공급자가 지원하는 파일 이름 확장명을 가지고 있는지 확인합니다. 그렇지 않은 경우 S_FALSE 즉시 반환하여 불필요한 처리를 방지합니다.

요구 사항

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