CertSrvBackupTruncateLogs 関数 (certbcli.h)

  • [アーティクル]

CertSrvBackupTruncateLogs 関数は、冗長なレコードを排除し、ログ ファイルで使用されるディスクストレージ領域を減らします。 ログ ファイルを切り捨てる前に、 CertSrvBackupGetDatabaseNames および CertSrvBackupGetBackupLogs によって返されるすべてのファイルのバックアップがセキュリティで保護されていることを確認します。

構文

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

パラメーター

[in] hbc

Certificate Services バックアップ コンテキストへのハンドル。

戻り値

戻り値は HRESULT です。 S_OK の値は成功を示します。

注釈

データベースとログ ファイルのバックアップをセキュリティで保護した後、必要に応じてログ ファイルを切り捨てることもできます。 ログ ファイルのボリュームはデータベース アクティビティに伴って増加し、ログ ファイルを切り捨てると、ログ ファイル内の冗長なレコードが減ります (ログ ファイルの格納に使用されるディスク領域が減少します)。

ログ ファイルは、データベースの整合性と効率のために提供されます。 Certificate Services アプリケーションで正常でない終了が発生した場合、次回 Certificate Services が開始されると、データベースはログ ファイルを再生して、データの破損がデータベースに導入されないようにします。

ログ ファイルのボリュームによっては、ログ ファイルの再生に時間がかかる場合があります。 この再生中、 証明機関 は他のアクティビティでは使用できなくなります。 証明書サービス アプリケーションが適切に停止されている場合 (サービスを停止したり、オペレーティング システムを適切にシャットダウンしたりするなど)、次回起動時にログ ファイルが再生されないことに注意してください。

メモCertSrvBackupTruncateLogs を呼び出し、CertSrvBackupGetDatabaseNames および CertSrvBackupGetBackupLogs から返されたすべてのファイルをバックアップせずに呼び出すと、バックアップ セットを正常に復元できないため、使用できない Certificate Services マシンが作成されます。 したがって、バックアップ セットに CertSrvBackupGetDatabaseNames および CertSrvBackupGetBackupLogs から返されるすべてのファイルが含まれている場合にのみ 、CertSrvBackupTruncateLogs を呼び出します。
 

例

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

こちらもご覧ください

CertSrvBackupGetBackupLogs

証明書サービスのバックアップと復元の機能の使用