次の方法で共有

IFhConfigMgr::QueryProtectionStatus メソッド (fhcfg.h)

  • [アーティクル]

現在のファイル履歴保護状態を取得します。

Note

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
 現在のユーザーの内部ファイル履歴情報を格納するファイルの 1 つに致命的なエラーがあります。 ファイルはバックアップされません。 この値は、 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
 現在割り当てられているターゲットには、ファイル履歴保護スコープからファイルのバックアップ コピーを格納するための十分な領域がないため、保持期間は既に最も積極的なポリシーに設定されています。 ファイル履歴では、保護レベルが低下します。 この値は 、現在の ユーザーに対してバックアップ サイクルが現在実行されていることを示すために、FH_STATE_RUNNING (0x100) の ORed にすることができます。
FH_STATE_TARGET_FULL
0x11
 現在割り当てられているターゲットには、ファイル履歴保護スコープからファイルのバックアップ コピーを格納するための十分な領域がありません。 ファイル履歴では、保護レベルが低下します。 この値は 、現在の ユーザーに対してバックアップ サイクルが現在実行されていることを示すために、FH_STATE_RUNNING (0x100) の ORed にすることができます。
FH_STATE_STAGING_FULL
0x12
 いずれかのローカル ディスクのファイル履歴キャッシュには、ファイル履歴保護スコープのファイルのバックアップ コピーを一時的に格納するための十分な領域がありません。 ファイル履歴では、保護レベルが低下します。 この値は 、現在の ユーザーに対してバックアップ サイクルが現在実行されていることを示すために、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
 保護されたファイルまたは保護スコープで行われた変更が多すぎます。 ファイル履歴の保護レベルは、ユーザーがバックグラウンドで実行される定期的なバックアップ サイクルに依存するのではなく、即時バックアップを明示的に開始しない限り、低下する可能性があります。 この値は 、現在の ユーザーに対してバックアップ サイクルが現在実行されていることを示すために、FH_STATE_RUNNING (0x100) の ORed にすることができます。
FH_STATE_NO_ERROR
0xFF
 ファイル履歴のバックアップは定期的に実行され、エラー状態は検出されません。最適なレベルのファイル履歴保護が提供されます。 この値は 、現在の ユーザーに対してバックアップ サイクルが現在実行されていることを示すために、FH_STATE_RUNNING (0x100) の ORed にすることができます。

[out] ProtectedUntilTime

ファイル履歴保護スコープ内のすべてのファイルが保護されるまでの日付と時刻を含む SysAllocString で割り当てられた文字列へのポインターを受け取ります。 日付と時刻は、システム ロケールごとに書式設定されます。 日付と時刻が不明な場合は、空の文字列が返されます。

次のいずれかの条件に該当する場合、ファイルは特定の時点まで保護されていると見なされます。

  • その時点以降にキャプチャされ、現在割り当てられているバックアップ ターゲットに完全にコピーされたファイルのバージョンがあります。
  • ファイルは、その時点以降に作成されたか、ファイル履歴保護スコープに含まれていました。

戻り値

このメソッドは、成功すると S_OK を返します。 それ以外の場合は、FhErrors.h ヘッダー ファイルで定義されている値の 1 つなどの HRESULT エラー コードが返されます。

解説

呼び出し元は、その上で SysFreeString を呼び出すことによって、ProtectedUntilTime に割り当てられたメモリを解放します。

保護状態は、ファイル履歴の操作状態と、保護スコープ内のすべてのファイルが保護されるまでの日時を示します。

ターゲットが完全または切断されている場合、ファイル履歴機能では、次のように機能低下レベルの保護が提供されます。

  • ファイルは、いずれかのローカル ディスクのファイル履歴キャッシュにバックアップされます。
  • この期間中にキャッシュがいっぱいになると、古いコピーがキャッシュから削除され、新しいコピーがバックアップされます。
  • ターゲットが空き領域が少ない場合、ターゲットがいっぱいになると、機能低下レベルの保護が開始されます。

要件

   
サポートされている最小のクライアント Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー fhcfg.h

関連項目

FhConfigMgr

IFhConfigMgr