CertSrvBackupTruncateLogs 関数 (certbcli.h)
CertSrvBackupTruncateLogs 関数は、冗長なレコードを排除し、ログ ファイルで使用されるディスクストレージ領域を減らします。 ログ ファイルを切り捨てる前に、 CertSrvBackupGetDatabaseNames および CertSrvBackupGetBackupLogs によって返されるすべてのファイルのバックアップがセキュリティで保護されていることを確認します。
構文
HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
[in] HCSBC hbc
);
パラメーター
[in] hbc
Certificate Services バックアップ コンテキストへのハンドル。
戻り値
戻り値は HRESULT です。 S_OK の値は成功を示します。
注釈
データベースとログ ファイルのバックアップをセキュリティで保護した後、必要に応じてログ ファイルを切り捨てることもできます。 ログ ファイルのボリュームはデータベース アクティビティに伴って増加し、ログ ファイルを切り捨てると、ログ ファイル内の冗長なレコードが減ります (ログ ファイルの格納に使用されるディスク領域が減少します)。
ログ ファイルは、データベースの整合性と効率のために提供されます。 Certificate Services アプリケーションで正常でない終了が発生した場合、次回 Certificate Services が開始されると、データベースはログ ファイルを再生して、データの破損がデータベースに導入されないようにします。
ログ ファイルのボリュームによっては、ログ ファイルの再生に時間がかかる場合があります。 この再生中、 証明機関 は他のアクティビティでは使用できなくなります。 証明書サービス アプリケーションが適切に停止されている場合 (サービスを停止したり、オペレーティング システムを適切にシャットダウンしたりするなど)、次回起動時にログ ファイルが再生されないことに注意してください。
例
FNCERTSRVBACKUPTRUNCATELOGS* pfnTruncateLogs;
char * szTruncateLogsFunc = "CertSrvBackupTruncateLogs";
HRESULT hr=0;
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnTruncateLogs = (FNCERTSRVBACKUPTRUNCATELOGS*)GetProcAddress( hInst,
szTruncateLogsFunc );
if ( NULL == pfnTruncateLogs )
{
printf("Failed GetProcAddress - %s, error=%d\n",
szTruncateLogsFunc,
GetLastError() );
exit(1); // Or other appropriate error action.
}
// After they have been backed up, truncate the logs.
// hCSBC is a previously set HCSBC variable.
hr = pfnTruncateLogs(hCSBC);
if (FAILED(hr))
{
printf("Failed pfnTruncateLogs call [%x]\n", hr);
exit(1); // Or other appropriate error action.
}
else
printf("Logs truncated\n");
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | certbcli.h (Certsrv.h を含む) |
| Library | Certadm.lib |
| [DLL] | Certadm.dll |