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 포함) |
라이브러리 | Certadm.lib |
DLL | Certadm.dll |