SHCOLUMNDATA 구조체(shlobj.h)

특정 파일을 식별하는 정보를 포함합니다. 특정 파일에 대한 데이터를 요청할 때 IColumnProvider::GetItemData 에서 사용됩니다.

구문

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

멤버

dwFlags

형식: ULONG

요청의 특성을 지정하는 데 사용되는 플래그입니다.

SHCDF_UPDATEITEM

wszFile으로 지정된 파일은 IColumnProvider::GetItemData에 대한 마지막 호출 이후 변경된 새 파일 또는 파일입니다. 캐시된 데이터는 플러시하고 다시 계산해야 합니다. 데이터를 캐시하지 않거나 파일과 별도로 저장된 데이터를 표시하는 열 처리기는 이 플래그를 무시할 수 있습니다.

dwFileAttributes

형식:DWORD

파일 특성 플래그입니다. 다음 값 중 하나 이상이 됩니다.

FILE_ATTRIBUTE_ARCHIVE

파일 또는 디렉터리가 보관 파일 또는 디렉터리입니다. 애플리케이션은 이 특성을 사용하여 파일을 백업 또는 제거로 표시합니다.

FILE_ATTRIBUTE_COMPRESSED

파일 또는 디렉터리가 압축됩니다. 파일의 경우 파일의 모든 데이터가 압축됨을 의미합니다. 디렉터리의 경우 압축이 새로 만든 파일 및 하위 디렉터리의 기본값임을 의미합니다.

FILE_ATTRIBUTE_DIRECTORY

핸들은 디렉터리를 식별합니다.

FILE_ATTRIBUTE_ENCRYPTED

파일이나 디렉터리가 암호화되어 있습니다. 파일의 경우 파일의 모든 데이터 스트림이 암호화됨을 의미합니다. 디렉터리의 경우 암호화가 새로 만든 파일 및 하위 디렉터리의 기본값임을 의미합니다.

FILE_ATTRIBUTE_HIDDEN

파일 또는 디렉터리가 숨겨져 있으며 일반 디렉터리 목록에 포함되지 않습니다.

FILE_ATTRIBUTE_NORMAL

파일 또는 디렉터리에 다른 특성 집합이 없습니다. 이 특성은 단독으로 사용될 때만 유효합니다.

FILE_ATTRIBUTE_OFFLINE

파일의 데이터를 즉시 사용할 수 없습니다. 이 특성은 파일 데이터가 오프라인 스토리지로 물리적으로 이동되었음을 나타냅니다. 이 특성은 Windows 2000의 계층적 스토리지 관리 소프트웨어인 Remote Storage에서 사용됩니다. 이 특성이 설정된 경우 열 처리기는 파일을 열지 않아야 합니다. 이렇게 하면 오프라인 스토리지에서 파일이 회수되기 때문입니다.

FILE_ATTRIBUTE_READONLY

파일 또는 디렉터리가 읽기 전용입니다. 애플리케이션은 파일을 읽을 수 있지만 파일을 읽거나 삭제할 수는 없습니다. 디렉터리의 경우 애플리케이션에서 디렉터리를 삭제할 수 없습니다.

FILE_ATTRIBUTE_REPARSE_POINT

파일에 연결된 재분석 지점이 있습니다.

FILE_ATTRIBUTE_SPARSE_FILE

파일이 스파스 파일입니다.

FILE_ATTRIBUTE_SYSTEM

파일 또는 디렉터리가 운영 체제의 일부이거나 운영 체제에서만 사용됩니다.

FILE_ATTRIBUTE_TEMPORARY

파일이 임시 스토리지에 사용되고 있습니다. 파일 시스템은 데이터를 대용량 스토리지로 다시 플러시하는 대신 더 빠르게 액세스할 수 있도록 모든 데이터를 메모리에 유지하려고 합니다. 임시 파일이 더 이상 필요하지 않게 되면 애플리케이션에서 이를 즉시 삭제해야 합니다.

dwReserved

형식: ULONG

예약되어 있습니다. NULL로 설정합니다.

pwszExt

형식: WCHAR*

파일 이름 확장명을 가진 null로 끝나는 유니코드 문자열에 대한 포인터입니다.

wszFile[MAX_PATH]

형식: WCHAR[MAX_PATH]

정규화된 파일 경로를 포함하는 null로 종료된 유니코드 문자열입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
머리글	shlobj.h

추가 정보

GetFileAttributes