CertSrvBackupTruncateLogs 함수(certbcli.h)

  • 아티클

CertSrvBackupTruncateLogs 함수는 중복 레코드를 제거하고 로그 파일에 사용되는 디스크 스토리지 공간을 줄입니다. 로그 파일을 잘리기 전에 CertSrvBackupGetDatabaseNames 및 CertSrvBackupGetBackupLogs 에서 반환된 모든 파일의 백업이 보호되었는지 확인합니다.

구문

HRESULT CERTBCLI_API CertSrvBackupTruncateLogs(
  [in] HCSBC hbc
);

매개 변수

[in] hbc

Certificate Services 백업 컨텍스트에 대한 핸들입니다.

반환 값

반환 값은 HRESULT입니다. S_OK 값은 성공을 나타냅니다.

설명

데이터베이스 및 로그 파일의 백업을 보호한 후에는 필요에 따라 로그 파일을 잘라낼 수 있습니다. 데이터베이스 작업으로 로그 파일 볼륨이 증가하고 로그 파일을 잘리면 로그 파일의 중복 레코드가 줄어듭니다(로그 파일을 저장하는 데 사용되는 디스크 공간 감소).

로그 파일은 데이터베이스 무결성 및 효율성을 위해 제공됩니다. Certificate Services 애플리케이션에서 정상적이지 않은 종료가 발생하면 다음에 Certificate Services가 시작될 때 데이터베이스는 로그 파일을 재생하여 데이터 손상이 데이터베이스에 도입되지 않도록 합니다.

로그 파일의 볼륨에 따라 로그 파일 재생은 시간이 많이 걸리는 프로세스일 수 있습니다. 이 재생 중에는 다른 활동에 인증 기관을 사용할 수 없습니다. 인증서 서비스 애플리케이션이 제대로 중지된 경우(예: 서비스를 중지하거나 운영 체제를 제대로 종료하여) 다음에 시작될 때 로그 파일이 재생되지 않습니다.

참고CertSrvBackupGetDatabaseNames 및 CertSrvBackupGetBackupLogs에서 반환된 모든 파일을 백업하지 않고 CertSrvBackupTruncateLogs를 호출하는 경우 백업 집합을 성공적으로 복원할 수 없으므로 사용할 수 없는 인증서 서비스 컴퓨터가 생성됩니다. 따라서 백업 집합에 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 포함)
라이브러리 Certadm.lib
DLL Certadm.dll

추가 정보

CertSrvBackupGetBackupLogs

인증서 서비스 백업 및 복원 함수 사용