다음을 통해 공유


IFsiFileItem2::p ut_IsRealTime 메서드(imapi2fs.h)

파일 시스템에서 파일의 '실시간' 특성을 설정합니다. 이 특성은 콘텐츠에 오디오 및 비디오 데이터와 같은 쓰기 또는 읽기 시 최소 데이터 전송 속도가 필요한지 여부를 지정합니다.

구문

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

매개 변수

[in] newVal

파일 시스템 이미지에서 파일의 Real-Time 특성을 설정하려면 VARIANT_TRUE 지정합니다. 그렇지 않으면 VARIANT_FALSE. 기본값은 VARIANT_FALSE.

반환 값

S_OK 성공하면 반환되지만 구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.

반환 코드/값 설명
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
값: 0x00AAB15FL
기능은 현재 파일 시스템 수정 버전에 대해 지원되지 않으므로 파일은 Real-Time 표시되었지만 파일 시스템 개체에서 UDF 수정 버전 2.01 이상을 사용하도록 설정하지 않으면 결과 파일 시스템 이미지에 표시되지 않습니다.
IMAPI_E_PROPERTY_NOT_ACCESSIBLE
값: 0xC0AAB160L
속성 '%1!ls!' 에 액세스할 수 없습니다.
IMAPI_E_INVALID_PARAM
값: 0xC0AAB101
'%1!ls!' 매개 변수에 지정된 값입니다. 잘못되었습니다.
 
참고 현재 이 메서드를 사용하여 CreateResultImage 작업의 결과로 '읽기 전용'인 파일의 Real-Time 특성 값을 설정할 때 S_OK 반환됩니다.
 

설명

IFsiDirectoryItem::AddTreeIFsiDirectoryItem2::AddTreeWithNamedStreams 메서드는 파일 시스템 이미지에 파일을 추가하는 동안 Real-Time 특성을 설정하지 않습니다. 파일을 실시간 파일로 표시하려면 파일 시스템 이미지에 추가된 후 열거되고 Real-Time 특성을 개별적으로 설정해야 합니다.

명명된 스트림을 나타내는 파일 항목에 대해 이 메서드를 호출하면 명명된 스트림에 Real-Time 특성이 없으므로 이 메서드는 IMAPI_E_PROPERTY_NOT_ACCESSIBLE 오류 코드를 반환합니다.

이 방법은 Windows Server 2003 SP1(서비스 팩 1), Windows XP SP2(서비스 팩 2) 및 Windows Vista에서 스토리지용 Windows 기능 팩을 통해 지원됩니다. 이 업데이트 패키지에서 제공하는 모든 기능은 기본적으로 Windows 7 및 Windows Server 2008 R2에서 지원됩니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imapi2fs.h

추가 정보

IFsiFileItem2