CertSrvBackupOpenFileW 함수(certbcli.h)

CertSrvBackupOpenFile 함수는 백업을 위한 파일을 엽니다.

구문

HRESULT CERTBCLI_API CertSrvBackupOpenFileW(
  [in]  HCSBC         hbc,
  [in]  WCHAR const   *pwszAttachmentName,
  [in]  DWORD         cbReadHintSize,
  [out] LARGE_INTEGER *pliFileSize
);

매개 변수

[in] hbc

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

[in] pwszAttachmentName

백업을 위해 열 파일 이름입니다. 이 파일 이름은 CertSrvBackupGetBackupLogs 또는 CertSrvBackupGetDatabaseNames를 통해 생성된 목록에서 구문 분석됩니다. CertSrvBackupGetBackupLogs 및 CertSrvBackupGetDatabaseNames에서 반환되는 이름은 CertSrvBackupOpenFile이 호출되기 전에 단일 WCHAR CSBFT_* 접두사를 제거해야 합니다.

[in] cbReadHintSize

CertSrvBackupRead에서 파일을 읽을 때 힌트로 사용되는 바이트 수입니다. 백업 컨텍스트에 대한 첫 번째 CertSrvBackupOpenFile 호출에 전달된 cbReadHintSize 매개 변수를 사용하여 읽기 버퍼 크기를 조정합니다. 이 매개 변수에 대해 0을 전달하면 버퍼의 크기가 CertSrvBackupOpenFile에서 선택한 비교적 효율적인 크기로 조정됩니다. 메모리가 부족한 경우 메모리 할당이 성공할 때까지 또는 버퍼 크기가 가능한 최소 값에 도달할 때까지 버퍼 크기가 줄어듭니다. 0이 아닌 크기를 전달하여 CertSrvBackupOpenFile 이 버퍼 크기를 cbReadHintSize 값에 가까운 2의 전력으로 조정합니다. 구현은 64KB에서 4MB 사이의 두 가지 권한만 선택합니다.

[out] pliFileSize

파일의 바이트 수를 나타내는 LARGE_INTEGER 값에 대한 포인터입니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

이 함수를 사용하여 백업을 위해 파일을 엽니다. 파일 사용을 마쳤으면 CertSrvBackupClose 함수를 호출하여 파일을 닫습니다.

Certadm.dll 이 함수의 이름은 CertSrvBackupOpenFileW입니다. GetProcAddress를 호출할 때 이 형식의 이름을 사용해야 합니다. 또한 이 함수는 Certbcli.h에서 FNCERTSRVBACKUPOPENFILEW 형식으로 정의됩니다.

예제

FNCERTSRVBACKUPOPENFILEW* pfnOpenFile;
char * szBackupOpenFunc = "CertSrvBackupOpenFileW";
LARGE_INTEGER liFileSize;
HRESULT       hr=0;

// Get the address for the desired function.    
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnOpenFile = (FNCERTSRVBACKUPOPENFILEW*)GetProcAddress(hInst,
                                         szBackupOpenFunc);
if ( NULL == pfnOpenFile )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
            szBackupOpenFunc,
            GetLastError() );
    exit(1); // or other appropriate error action
}

// Open the file.
// hCSBC was set by an earlier call to CertSrvBackupPrepare.
// pwszFile specifies the name of a file.
// This name could have resulted from parsing the
// output from CertSrvBackupGetDatabaseNames, and so on.
hr = pfnOpenFile(hCSBC,
                pwszFile,
                0,
                &liFileSize);
if (FAILED(hr))
{
    printf("Failed pfnOpenFile call [%x] %ws\n",
           hr,
           pwszFile);
           exit(1); // Or other appropriate error action.
}

// Use the opened file as needed.
// When you have finished using the file, call CertSrvBackupClose.
// ...

요구 사항

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

추가 정보

CertSrvBackupClose

CertSrvBackupRead

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