Share via

IFhConfigMgr::QueryProtectionStatus 메서드(fhcfg.h)

  • 아티클

현재 파일 기록 보호 상태를 검색합니다.

참고

IFhConfigMgr 은 더 이상 사용되지 않으며 향후 릴리스에서 변경되거나 사용할 수 없습니다.

구문

HRESULT QueryProtectionStatus(
  [out] DWORD *ProtectionState,
  [out] BSTR  *ProtectedUntilTime
);

매개 변수

[out] ProtectionState

반환 시 이 매개 변수는 현재 파일 기록 보호 상태를 받습니다. 다음 보호 상태는 FhStatus.h 헤더 파일에 정의되어 있습니다.

값 의미
FH_STATE_NOT_TRACKED
0x00
 파일 기록 서비스가 시작되지 않았거나 현재 사용자가 추적되지 않으므로 파일 기록 보호 상태를 알 수 없습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다.
FH_STATE_OFF
0x01
 현재 사용자에 대해 파일 기록 보호를 사용할 수 없습니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다.
FH_STATE_DISABLED_BY_GP
0x02
 파일 기록 보호는 그룹 정책 사용하지 않도록 설정됩니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다.
FH_STATE_FATAL_CONFIG_ERROR
0x03
 현재 사용자의 내부 파일 기록 정보를 저장하는 파일 중 하나에 심각한 오류가 있습니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다.
FH_STATE_TARGET_ACCESS_DENIED
0x0E
 현재 사용자에게 현재 할당된 대상에 대한 쓰기 권한이 없습니다. 파일 버전의 백업 복사본은 만들어지지 않습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_VOLUME_DIRTY
0x0F
 현재 할당된 대상이 더티 표시되었습니다. 파일 버전의 백업 복사본은 Chkdsk 유틸리티가 실행될 때까지 만들어지지 않습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_FULL_RETENTION_MAX
0x10
 현재 할당된 대상에는 파일 기록 보호 scope 파일의 백업 복사본을 저장할 충분한 공간이 없으며 보존은 이미 가장 공격적인 정책으로 설정되어 있습니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_FULL
0x11
 현재 할당된 대상에는 파일 기록 보호 scope 파일의 백업 복사본을 저장할 공간이 부족합니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_STAGING_FULL
0x12
 로컬 디스크 중 하나의 파일 기록 캐시에는 파일 기록 보호 scope 파일의 백업 복사본을 일시적으로 저장할 공간이 부족합니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_LOW_SPACE_RETENTION_MAX
0x13
 현재 할당된 대상은 사용 가능한 공간이 부족하며 보존은 이미 가장 공격적인 정책으로 설정되어 있습니다. 파일 기록 보호 수준은 곧 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_LOW_SPACE
0x14
 현재 할당된 대상이 사용 가능한 공간이 부족합니다. 파일 기록 보호 수준은 곧 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TARGET_ABSENT
0x15
 현재 할당된 대상은 상당한 기간 동안 백업에 사용할 수 없으므로 파일 기록 보호 수준이 저하됩니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_TOO_MUCH_BEHIND
0x16
 보호된 파일 또는 보호 scope 너무 많이 변경되었습니다. 사용자가 백그라운드에서 수행할 정기적인 백업 주기에 의존하지 않고 즉시 백업을 명시적으로 시작하지 않는 한 파일 기록 보호 수준이 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.
FH_STATE_NO_ERROR
0xFF
 파일 기록 백업은 정기적으로 수행되며 오류 조건이 검색되지 않으며 최적의 수준의 파일 기록 보호가 제공됩니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다.

[out] ProtectedUntilTime

파일 기록 보호 scope 내의 모든 파일이 보호될 때까지 날짜와 시간을 포함하는 SysAllocString으로 할당된 문자열에 대한 포인터를 받습니다. 날짜 및 시간은 시스템 로캘에 따라 형식이 지정됩니다. 날짜와 시간을 알 수 없는 경우 빈 문자열이 반환됩니다.

다음 조건 중 하나가 true인 경우 특정 시점까지 파일이 보호되는 것으로 간주됩니다.

  • 해당 시점 또는 그 이후에 캡처되고 현재 할당된 백업 대상에 완전히 복사된 해당 파일의 버전이 있습니다.
  • 파일이 생성되었거나 해당 시점 이후에 파일 기록 보호 scope 포함되었습니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 FhErrors.h 헤더 파일에 정의된 값 중 하나와 같은 HRESULT 오류 코드를 반환합니다.

설명

호출자는 SysFreeString을 호출하여 ProtectedUntilTime에 할당된 메모리를 해제할 책임이 있습니다.

보호 상태는 파일 기록 작업 상태와 보호 scope 내의 모든 파일이 보호될 때까지의 날짜와 시간을 나타냅니다.

대상이 가득 차거나 연결이 끊어진 경우 파일 기록 기능은 다음과 같이 성능이 저하된 수준의 보호를 제공합니다.

  • 파일은 로컬 디스크 중 하나의 파일 기록 캐시에 백업됩니다.
  • 이 시간 동안 캐시가 채워지면 캐시에서 이전 복사본이 삭제되어 최신 복사본을 백업합니다.
  • 대상이 사용 가능한 공간이 부족하면 대상이 가득 차면 성능이 저하된 보호 수준이 시작됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fhcfg.h

추가 정보

FhConfigMgr

IFhConfigMgr