DsBackupTruncateLogs 関数

[この関数は、[要件] セクションで指定されたオペレーティングシステムで使用できます。それより後のバージョンでは、変更されるか、使用できなくなる場合があります。 Windows Vista 以降では、代わりにボリュームシャドウコピーサービス (VSS) を使用します。

DsBackupTruncateLogs 関数は、以前に読み取ったバックアップログを切り捨てます。

構文

HRESULT DsBackupTruncateLogs(
  _In_ HBC hbc
);

関数が 成功した場合はS_OK を返し、それ以外の場合は Win32 または RPC エラーコードを返します。次の一覧に、考えられるその他のエラーコードを示します。

ERROR_ACCESS_DENIED: 呼び出し元には、この関数を呼び出す適切なアクセス特権がありません。 DsSetAuthIdentity 関数を使用して、バックアップおよび復元関数に使用する資格情報を設定できます。
ERROR_INVALID_PARAMETER: hbc が無効です。

完全バックアップまたは増分バックアップが正常に完了した場合は、DsBackupTruncateLogs 関数を使用します。

注意

差分バックアップの後にこの関数を呼び出すと、すべての増分バックアップ情報が失われます。