CertSrvBackupPrepareW 함수(certbcli.h)

  • 아티클

CertSrvBackupPrepare 함수는 백업 작업을 위해 인증서 서비스 서버를 준비하는 데 사용됩니다.

구문

HRESULT CERTBCLI_API CertSrvBackupPrepareW(
  [in]  WCHAR const *pwszServerName,
  [in]  ULONG       grbitJet,
  [in]  ULONG       dwBackupFlags,
  [out] HCSBC       *phbc
);

매개 변수

[in] pwszServerName

온라인 백업을 준비할 서버의 컴퓨터 이름에 대한 포인터입니다. 이 이름은 NetBIOS 이름 또는 DNS 이름일 수 있습니다.

[in] grbitJet

데이터베이스 엔진에서 사용하는 값입니다. 이 값은 0으로 설정해야 합니다.

[in] dwBackupFlags

백업 유형을 지정합니다. 다음 값 중 하나일 수 있습니다.

값 의미
CSBACKUP_TYPE_FULL
 Certificate Services 데이터베이스, 로그 및 관련 파일을 백업합니다.
CSBACKUP_TYPE_LOGS_ONLY
 로그 파일만 백업합니다.

[out] phbc

인증서 서비스 백업 컨텍스트 핸들(HCSBC)에 대한 포인터입니다.

반환 값

반환 값은 HRESULT입니다. S_OK 값은 성공을 나타내고 *phbc 는 다른 Certificate Services 백업 API에서 사용할 수 있는 HCSBC 로 설정됩니다.

설명

인증서 서비스 백업이 수행되기 전에 CertSrvBackupPrepare를 사용하여 HCSBC를 만들어야 합니다. 결과 HCSBC 는 파일을 나열, 열기, 읽기 및 닫고 로그 파일을 자르는 데 사용할 수 있는 Certificate Services 백업 함수의 필수 매개 변수입니다.

참고 백업 세션이 완료되면 CertSrvBackupEnd를 호출하여 CertSrvBackupPrepare 호출로 인한 HCSBC를 해제해야 합니다.
 
Certadm.dll 이 함수의 이름은 CertSrvBackupPrepareW입니다. GetProcAddress를 호출할 때 이 형식의 이름을 사용해야 합니다. 또한 이 함수는 Certbcli.h 헤더 파일에서 FNCERTSRVBACKUPPREPAREW 형식으로 정의됩니다.

이 호출을 실행하려면 백업 권한이 있어야 합니다. 자세한 내용은 백업 및 복원 권한 설정을 참조하세요.

예제

WCHAR *    wszServer = L"MyCertServerMachine";
FNCERTSRVBACKUPPREPAREW* pfnBackupPrepare;
char * szBackPrepFunc = "CertSrvBackupPrepareW";
HINSTANCE  hInst=0;
HCSBC      hCSBC=NULL;
HRESULT    hr=0;

// Load the DLL.
hInst = LoadLibrary(L"Certadm.dll");
if ( NULL == hInst )
{
    printf("Failed LoadLibrary, error=%d\n",
            GetLastError() );
    exit(1); // Or other appropriate error action.
}
// Get the address for the desired function.
pfnBackupPrepare = (FNCERTSRVBACKUPPREPAREW*)GetProcAddress( hInst,
                                        szBackPrepFunc );
if ( NULL == pfnBackupPrepare )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szBackPrepFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Prepare CertServ for backup.
hr = pfnBackupPrepare(wszServer,
                      0,
                      CSBACKUP_TYPE_FULL,
                      &hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnBackupPrepare call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

// Use the HCSBC for backup operations.
// ...

// When done processing, release the HCSBC context
// by calling CertSrvBackupEnd (not shown here).
// ...


// Done processing, free the DLL.
if (hInst)
    FreeLibrary(hInst);

요구 사항

요구 사항 값
지원되는 최소 클라이언트 지원되는 버전 없음
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 certbcli.h(Certsrv.h 포함)
라이브러리 Certadm.lib
DLL Certadm.dll

추가 정보

CertSrvBackupEnd

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