_SHCONTF 열거형(shobjidl_core.h)

  • 아티클

열거형에 포함된 항목의 유형을 결정합니다. 이러한 값은 IShellFolder::EnumObjects 메서드와 함께 사용됩니다.

Syntax

typedef enum _SHCONTF {
  SHCONTF_CHECKING_FOR_CHILDREN = 0x10,
  SHCONTF_FOLDERS = 0x20,
  SHCONTF_NONFOLDERS = 0x40,
  SHCONTF_INCLUDEHIDDEN = 0x80,
  SHCONTF_INIT_ON_FIRST_NEXT = 0x100,
  SHCONTF_NETPRINTERSRCH = 0x200,
  SHCONTF_SHAREABLE = 0x400,
  SHCONTF_STORAGE = 0x800,
  SHCONTF_NAVIGATION_ENUM = 0x1000,
  SHCONTF_FASTITEMS = 0x2000,
  SHCONTF_FLATLIST = 0x4000,
  SHCONTF_ENABLE_ASYNC = 0x8000,
  SHCONTF_INCLUDESUPERHIDDEN = 0x10000
} ;

상수

 
SHCONTF_CHECKING_FOR_CHILDREN
값: 0x10
0x00010. Windows 7 이상. 호출 애플리케이션이 폴더에 자식 항목이 있는지 확인합니다.
SHCONTF_FOLDERS
값: 0x20
0x00020. 열거형에 폴더인 항목을 포함합니다.
SHCONTF_NONFOLDERS
값: 0x40
0x00040. 열거형에 폴더가 아닌 항목을 포함합니다.
SHCONTF_INCLUDEHIDDEN
값: 0x80
0x00080. 열거형에 숨겨진 항목을 포함합니다. 여기에는 숨겨진 시스템 항목이 포함되지 않습니다. (숨겨진 시스템 항목을 포함하려면 SHCONTF_INCLUDESUPERHIDDEN 사용합니다.)
SHCONTF_INIT_ON_FIRST_NEXT
값: 0x100
0x00100. 더 이상 사용되지 않습니다. 항상 가정합니다. IShellFolder::EnumObjects는 열거형 개체의 유효성을 검사하지 않고 반환할 수 있습니다. IEnumIDList::Next에 대한 첫 번째 호출까지 유효성 검사를 연기할 수 있습니다. 첫 번째 IEnumIDList::Next 호출 전에 사용자 인터페이스가 표시될 수 있는 경우 이 플래그를 사용합니다. 사용자 인터페이스를 표시하려면 hwnd 를 유효한 창 핸들로 설정해야 합니다.
SHCONTF_NETPRINTERSRCH
값: 0x200
0x00200. 호출 애플리케이션에서 프린터 개체를 찾고 있습니다.
SHCONTF_SHAREABLE
값: 0x400
0x00400. 호출 애플리케이션은 공유할 수 있는 리소스를 찾고 있습니다.
SHCONTF_STORAGE
값: 0x800
0x00800. 숨겨진 항목을 포함하여 액세스 가능한 스토리지 및 상위 항목이 있는 항목을 포함합니다.
SHCONTF_NAVIGATION_ENUM
값: 0x1000
0x01000. Windows 7 이상. 자식 폴더는 탐색 열거형을 제공해야 합니다.
SHCONTF_FASTITEMS
값: 0x2000
0x02000. Windows Vista 이상. 호출 애플리케이션은 신속하게 열거할 수 있는 리소스를 찾고 있습니다.
SHCONTF_FLATLIST
값: 0x4000
0x04000. Windows Vista 이상. 사용되지 않습니다. 사용하지 마십시오.
SHCONTF_ENABLE_ASYNC
값: 0x8000
0x08000. Windows Vista 이상. 호출 애플리케이션은 변경 알림을 모니터링합니다. 즉, 열거자가 모든 결과를 반환할 필요는 없습니다. 변경 알림을 통해 항목을 보고할 수 있습니다.
SHCONTF_INCLUDESUPERHIDDEN
값: 0x10000
0x10000. Windows 7 이상. 열거형에 숨겨진 시스템 항목을 포함합니다. 이 값에는 숨겨진 비 시스템 항목이 포함되지 않습니다. (숨겨진 비시스템 항목을 포함하려면 SHCONTF_INCLUDEHIDDEN 사용합니다.)

설명

SHCONTF_INIT_ON_FIRST_NEXT 플래그를 설정하면 호출 애플리케이션은 IShellFolder::EnumObjects 메서드가 초기화되지 않은 열거형 개체를 반환하여 열거형 프로세스를 신속하게 처리할 수 있음을 제안합니다. 열거형 프로세스가 시작될 때까지 초기화를 연기할 수 있습니다. 열거형 개체 초기화가 긴 프로세스인 경우 메서드 구현은 초기화되지 않은 개체를 즉시 반환해야 합니다. IEnumIDList::Next 메서드가 처음 호출될 때까지 초기화를 연기합니다. 초기화에 사용자 입력이 필요한 경우 메서드 구현은 hwnd 를 사용자 인터페이스의 부모 창으로 사용해야 합니다. hwnd가 NULL로 설정된 경우 수행할 작업에 대한 설명은 IShellFolder::EnumObjects 참조를 참조하세요.

참고 이 열거형의 이름이 Windows Vista에서 _SHCONTF 변경되었습니다. 이전에는 tagSHCONTF라는 이름이 지정되었습니다. 레거시 코드와의 호환성을 위해 SHCONTF 라는 이름은 typedef 문을 통해 DWORD의 동의어로 정의됩니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 shobjidl_core.h(Shobjidl.h 포함)