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 |