IFhConfigMgr::QueryProtectionStatus 메서드(fhcfg.h)
현재 파일 기록 보호 상태를 검색합니다.
참고
IFhConfigMgr 은 더 이상 사용되지 않으며 향후 릴리스에서 변경되거나 사용할 수 없습니다.
구문
HRESULT QueryProtectionStatus(
[out] DWORD *ProtectionState,
[out] BSTR *ProtectedUntilTime
);
매개 변수
[out] ProtectionState
반환 시 이 매개 변수는 현재 파일 기록 보호 상태를 받습니다. 다음 보호 상태는 FhStatus.h 헤더 파일에 정의되어 있습니다.
| 값 | 의미 |
|---|---|
|
파일 기록 서비스가 시작되지 않았거나 현재 사용자가 추적되지 않으므로 파일 기록 보호 상태를 알 수 없습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다. |
|
현재 사용자에 대해 파일 기록 보호를 사용할 수 없습니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다. |
|
파일 기록 보호는 그룹 정책 사용하지 않도록 설정됩니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다. |
|
현재 사용자의 내부 파일 기록 정보를 저장하는 파일 중 하나에 심각한 오류가 있습니다. 파일이 백업되지 않습니다. 이 값은 FH_STATE_RUNNING(0x100 )으로 ORed할 수 없습니다. |
|
현재 사용자에게 현재 할당된 대상에 대한 쓰기 권한이 없습니다. 파일 버전의 백업 복사본은 만들어지지 않습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상이 더티 표시되었습니다. 파일 버전의 백업 복사본은 Chkdsk 유틸리티가 실행될 때까지 만들어지지 않습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상에는 파일 기록 보호 scope 파일의 백업 복사본을 저장할 충분한 공간이 없으며 보존은 이미 가장 공격적인 정책으로 설정되어 있습니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상에는 파일 기록 보호 scope 파일의 백업 복사본을 저장할 공간이 부족합니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
로컬 디스크 중 하나의 파일 기록 캐시에는 파일 기록 보호 scope 파일의 백업 복사본을 일시적으로 저장할 공간이 부족합니다. 파일 기록은 성능이 저하된 보호 수준을 제공합니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상은 사용 가능한 공간이 부족하며 보존은 이미 가장 공격적인 정책으로 설정되어 있습니다. 파일 기록 보호 수준은 곧 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상이 사용 가능한 공간이 부족합니다. 파일 기록 보호 수준은 곧 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
현재 할당된 대상은 상당한 기간 동안 백업에 사용할 수 없으므로 파일 기록 보호 수준이 저하됩니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
보호된 파일 또는 보호 scope 너무 많이 변경되었습니다. 사용자가 백그라운드에서 수행할 정기적인 백업 주기에 의존하지 않고 즉시 백업을 명시적으로 시작하지 않는 한 파일 기록 보호 수준이 저하될 수 있습니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 FH_STATE_RUNNING (0x100)를 사용하여 ORed할 수 있습니다. |
|
파일 기록 백업은 정기적으로 수행되며 오류 조건이 검색되지 않으며 최적의 수준의 파일 기록 보호가 제공됩니다. 이 값은 현재 사용자에 대해 백업 주기가 수행되고 있음을 나타내기 위해 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 |