FhServiceBlockBackup 関数 (fhsvcctl.h)

この関数は、現在のユーザーのバックアップを一時的にブロックします。

注意

FhServiceBlockBackup は非推奨であり、今後のリリースで変更または使用できない可能性があります。

構文

HRESULT FhServiceBlockBackup(
  [in] FH_SERVICE_PIPE_HANDLE Pipe
);

[in] Pipe

以前の FhServiceOpenPipe 呼び出しによって返された通信チャネルハンドル。

成功時にS_OK するか、失敗した場合は 失敗した HRESULT 値。失敗した 可能性のある HRESULT 値には、FhErrors.h ヘッダーファイルで定義されている値が含まれます。

この関数は、 FhServiceUnblockBackup 関数が呼び出されるか、ファイル履歴サービスとの通信チャネルが FhServiceClosePipe を呼び出して閉じられるまで、現在のユーザーのバックアップを実行しないようにファイル履歴サービスに指示します。

ファイル履歴構成の再関連付けを実行する前に、この関数を呼び出して、ファイル履歴の構成とデータファイルが現在使用されていないことを確認します。 (それ以外の場合、 IFhReassociation::P erformReassociation メソッドが失敗する可能性があります)。