다음을 통해 공유

GETPROPERTYSTOREFLAGS 열거형(propsys.h)

  • 아티클

IShellItem2::GetPropertyStore 또는 IPropertyStoreFactory::GetPropertyStore와 같이 속성 저장소를 만드는 메서드에 의해 검색된 속성 저장소 개체를 수정하는 플래그를 나타냅니다.

Syntax

typedef enum GETPROPERTYSTOREFLAGS {
  GPS_DEFAULT = 0,
  GPS_HANDLERPROPERTIESONLY = 0x1,
  GPS_READWRITE = 0x2,
  GPS_TEMPORARY = 0x4,
  GPS_FASTPROPERTIESONLY = 0x8,
  GPS_OPENSLOWITEM = 0x10,
  GPS_DELAYCREATION = 0x20,
  GPS_BESTEFFORT = 0x40,
  GPS_NO_OPLOCK = 0x80,
  GPS_PREFERQUERYPROPERTIES = 0x100,
  GPS_EXTRINSICPROPERTIES = 0x200,
  GPS_EXTRINSICPROPERTIESONLY = 0x400,
  GPS_VOLATILEPROPERTIES = 0x800,
  GPS_VOLATILEPROPERTIESONLY = 0x1000,
  GPS_MASK_VALID = 0x1fff
} ;

상수

 
GPS_DEFAULT
값: 0
호출 프로세스의 의미: 모든 속성이 포함된 읽기 전용 속성 저장소를 반환합니다. 느린 항목(오프라인 파일)이 열리지 않습니다.



다른 플래그와의 조합: 다른 플래그로 재정의할 수 있습니다.
GPS_HANDLERPROPERTIESONLY
값: 0x1
호출 프로세스의 의미: 디스크, 네트워크 또는 디바이스에서 파일을 여는 속성 처리기에서 직접 속성만 포함합니다.



파일 폴더의 의미: 처리기에서 직접 속성을 포함합니다.

다른 폴더에 대한 의미: 파일 폴더에 위임할 때 이 플래그를 파일 폴더에 전달합니다. 는 MUX(멀티플렉싱)를 수행하지 않습니다. 파일 폴더를 위임하지 않는 경우 오류 코드를 반환하는 대신 이 플래그를 무시합니다.

다른 플래그와의 조합: GPS_TEMPORARY, GPS_FASTPROPERTIESONLY 또는 GPS_BESTEFFORT 결합할 수 없습니다.
GPS_READWRITE
값: 0x2
호출 프로세스의 의미: 항목에 속성을 쓸 수 있습니다. 참고: 저장소에는 읽기 전용 저장소보다 적은 속성이 포함될 수 있습니다.



파일 폴더의 의미: ReadWrite.

다른 폴더의 의미: ReadWrite. 참고: 기본 MUX를 사용하는 경우 기본 MUX가 ReadWrite를 지원하지 않으므로 단일 unmultiplexed 저장소를 반환합니다.

다른 플래그와의 조합: GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT 또는 GPS_DELAYCREATION 결합할 수 없습니다. GPS_HANDLERPROPERTIESONLY 의미합니다.
GPS_TEMPORARY
값: 0x4
호출 프로세스의 의미: 셸 항목 instance 수명 동안 존재하는 초기 속성이 없는 쓰기 가능한 저장소를 제공합니다. 기본적으로 항목에 연결된 속성 모음은 instance.



파일 폴더에 대한 의미: 해당 없음. 셸 항목에 의해 처리됩니다.

다른 폴더에 대한 의미: 해당 없음. 셸 항목에 의해 처리됩니다.

다른 플래그와의 조합: 다른 플래그와 결합할 수 없습니다. GPS_READWRITE 의미합니다.
GPS_FASTPROPERTIESONLY
값: 0x8
호출 프로세스의 의미: 디스크 또는 네트워크에서 읽지 않는 저장소를 제공합니다. 참고: 이 플래그가 없는 저장소에 비해 일부 값이 다르거나 누락될 수 있습니다.



파일 폴더의 의미: "innate" 및 "대체" 저장소만 포함합니다. 처리기를 로드하지 마세요.

다른 폴더의 의미: 메모리에서 사용할 수 있거나 매우 빠르게 계산할 수 있는 속성만 포함합니다(디스크, 네트워크 또는 주변 장치 IO 디바이스의 속성 없음). 일반적으로 IDLIST의 데이터 원본입니다. 다른 폴더로 위임할 때 이 플래그를 전달합니다.

다른 플래그와의 조합: GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY 또는 GPS_DELAYCREATION 결합할 수 없습니다.
GPS_OPENSLOWITEM
값: 0x10
호출 프로세스의 의미: 필요한 경우 느린 항목(오프라인 파일)을 엽니다.



파일 폴더의 의미: 필요한 경우 오프라인 스토리지에서 파일을 검색합니다. 참고: 이 플래그가 없으면 오프라인 파일에 대한 처리기가 만들어지지 않습니다.

다른 폴더에 대한 의미: 매우 느린 속성을 반환하지 마세요.

다른 플래그와의 조합: GPS_TEMPORARY 또는 GPS_FASTPROPERTIESONLY 결합할 수 없습니다.
GPS_DELAYCREATION
값: 0x20
호출 프로세스의 의미: 이러한 액세스가 필요한 속성이 요청될 때까지 파일 액세스와 같은 메모리 집약적 작업을 지연합니다.



파일 폴더의 의미: 필요할 때까지 처리기를 만들지 마세요. 예를 들어 GetCount/GetAt 또는 GetValue가 있습니다. 여기서는 타고난 저장소가 요청을 충족하지 않습니다. 참고: 파일 액세스 문제로 인해 GetValue 가 실패할 수 있습니다.

다른 폴더의 의미: 폴더에 파일 폴더 또는 네트워크 액세스 위임과 같은 메모리 집약적 속성이 있는 경우 IDelayedPropertyStoreFactory 를 지원하고 속성을 빠르고 느린 저장소로 분할하여 성능을 최적화할 수 있습니다. 그런 다음 지연된 MUX를 사용하여 다시 결합할 수 있습니다.

다른 플래그와의 조합: GPS_TEMPORARY 또는 GPS_READWRITE 결합할 수 없습니다.
GPS_BESTEFFORT
값: 0x40
호출 프로세스의 의미: 일부 속성이 반환되지 않더라도 저장소를 가져오는 데 성공합니다. 참고: 이 플래그가 없는 저장소에 비해 일부 값이 다르거나 누락될 수 있습니다.



파일 폴더에 대한 의미: 처리기 또는 고유 저장소를 만드는 동안 오류가 발생하더라도 저장소를 성공하고 반환합니다. 하위 저장소가 실패하는 경우에만 실패합니다.

다른 폴더에 대한 의미: 일부 속성이 반환되지 않더라도 저장소를 가져오는 데 성공합니다.

다른 플래그와의 조합: GPS_TEMPORARY, GPS_READWRITE 또는 GPS_HANDLERPROPERTIESONLY 결합할 수 없습니다.
GPS_NO_OPLOCK
값: 0x80
Windows 7 이상. 호출자는 oplock이 없으면 바인딩 작업을 계속할 수 없으므로 파일에 기회 잠금(oplock)을 이미 보유하고 있는 경우에만 이 플래그를 사용해야 합니다. 기본적으로 셸은 속성 처리기에 바인딩하기 전에 파일에 대한 oplock을 요청합니다. 이 플래그는 기본 동작을 사용하지 않도록 설정합니다.

Windows Server 2008 및 Windows Vista: 이 플래그는 사용할 수 없습니다.
GPS_PREFERQUERYPROPERTIES
값: 0x100
Windows 8 이상. 이 플래그를 사용하여 WDS 결과에 대한 인덱서에서 속성만 검색합니다.
GPS_EXTRINSICPROPERTIES
값: 0x200
파일의 보조 스트림에서 속성을 포함합니다.
GPS_EXTRINSICPROPERTIESONLY
값: 0x400
파일의 보조 스트림에서 속성만 포함합니다.
GPS_VOLATILEPROPERTIES
값: 0x800
GPS_VOLATILEPROPERTIESONLY
값: 0x1000
GPS_MASK_VALID
값: 0x1fff
유효한 GETPROPERTYSTOREFLAGS 값에 대한 마스크입니다.

설명

Shell 항목이 파일인 경우 속성 저장소에는 다음 항목이 포함됩니다.

  • 파일과 관련된 파일 시스템의 속성입니다.
  • 파일이 오프라인 상태가 아닌 경우 파일의 속성 처리기에서 제공하는 파일 자체의 속성입니다(GPS_OPENSLOWITEM 참조).
파일이 아닌 셸 항목은 비슷한 읽기 전용 저장소를 반환합니다.
참고 GPS_INCLUDEOFFLINEPROPERTIES GPS_OPENSLOWITEM 대체되었습니다.
 

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 propsys.h