CertSrvRestoreRegisterThroughFile 함수는 인증서 서비스 복원을 등록합니다.
구문
HRESULT CERTBCLI_API CertSrvRestoreRegisterThroughFile(
[in] HCSBC hbc,
[in, optional] WCHAR const *pwszCheckPointFilePath,
[in, optional] WCHAR const *pwszLogPath,
[in, optional] CSEDB_RSTMAPW [] rgrstmap,
[in] LONG crstmap,
[in, optional] WCHAR const *pwszBackupLogPath,
[in] ULONG genLow,
[in] ULONG genHigh
);
매개 변수
[in] hbc
인증서 서비스 복원 컨텍스트에 대한 핸들입니다. 이 핸들은 CertSrvRestorePrepare 함수를 호출하여 가져옵니다.
[in, optional] pwszCheckPointFilePath
검사 지점 파일의 복원 경로를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 필요하지 않은 경우 이 매개 변수에 대해 NULL 을 전달합니다.
[in, optional] pwszLogPath
현재 로그 파일 디렉터리를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 필요하지 않은 경우 이 매개 변수에 대해 NULL 을 전달합니다.
[in, optional] rgrstmap
복원 맵을 포함하는 CSEDB_RSTMAP 구조체의 배열입니다. 전체 데이터베이스 복원을 수행하는 경우 이 매개 변수는 백업 데이터베이스의 이름과 데이터베이스가 복원된 후의 새 이름을 지정합니다. 백업 데이터베이스 이름은 pwszDatabaseName 멤버에 의해 참조되고 새 데이터베이스 이름은 pwszNewDatabaseName 멤버에서 참조됩니다. 백업 데이터베이스와 복원된 데이터베이스 모두에 대해 동일한 이름을 유지하려는 경우 pwszNewDatabaseName 및 pwszDatabaseName 멤버를 모두 동일한 이름으로 설정합니다. 백업 데이터베이스 이름은 CertSrvRestoreGetDatabaseLocations 함수에 대한 백업 클라이언트의 호출에서 반환된 경로에서 생성됩니다. CertSrvRestoreGetDatabaseLocations 는 전체 백업 중에 호출되었고 백업 클라이언트는 반환된 경로를 저장했을 것입니다.
증분 복원을 수행하는 경우 이 매개 변수를 NULL로 설정합니다.
[in] crstmap
rgrstmap 배열의 요소 수입니다. 전체 복원을 수행하는 경우 이 값을 1로 설정하거나 증분 복원을 수행하는 경우 0으로 설정합니다.
[in, optional] pwszBackupLogPath
백업 로그 디렉터리에 대한 경로를 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 필요하지 않은 경우 이 매개 변수에 대해 NULL 을 전달합니다.
[in] genLow
이 복원 세션에서 복원된 가장 낮은 로그 번호입니다. 로그 파일은 edbXXXXX.log 형식입니다. 여기서 XXXXX는 56진수 값입니다. 예를 들어 edb00001.log 내부 데이터베이스에서 만든 첫 번째 로그 파일입니다. 이 함수의 목적을 위해 genLow 의 값은 로그 파일 edb00001.log 해당합니다.
[in] genHigh
이 복원 세션에서 복원된 가장 높은 로그 번호입니다.
반환 값
반환 값은 HRESULT입니다. S_OK 값은 성공을 나타냅니다.
설명
이 함수는 CertSrvRestoreRegister 가 호출 계정이 로컬 관리자여야 한다는 점을 제외하고 CertSrvRestoreRegister 함수와 동일합니다. CertSrvRestoreRegisterThroughFile 함수는 호출 계정에 복원 권한이 있어야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | certbcli.h(Certsrv.h 포함) |
| 라이브러리 | Certadm.lib |
| DLL | Certadm.dll |