DsRestoreRegister 함수

[이 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista부터 VSS(볼륨 섀도 복사본 서비스) 를 대신 사용합니다.]

DsRestoreRegister 함수는 복원 작업을 등록합니다. 이 함수는 모든 후속 복원 작업을 연동하고 DsRestoreRegisterComplete 함수가 호출될 때까지 복원 대상이 시작되지 않도록 합니다.

구문

HRESULT DsRestoreRegister(
  _In_ HBC        hbc,
  _In_ LPCTSTR    szCheckPointFilePath,
  _In_ LPCTSTR    szLogPath,
  _In_ EDB_RSTMAP rgrstmap[],
  _In_ LONG       crstmap,
  _In_ LPCTSTR    szBackupLogPath,
  _In_ ULONG      genLow,
  _In_ ULONG      genHigh
);

매개 변수

hbc [in]

DsRestorePrepare 함수를 사용하여 가져온 복원 컨텍스트 핸들을 포함합니다.

szCheckPointFilePath [in]

검사점 파일의 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 경로는 DsRestoreGetDatabaseLocations 함수에서 제공되며 BFT 값은 BFT_CHECKPOINT_DIR. 일반적으로 시스템 데이터베이스 경로와 동일합니다. 이 경로는 적절한 백업 복원 함수에 필요합니다. 이 매개 변수는 NULL일 수 없습니다. 이 매개 변수에 NULL 을 전달하면 복원 프로세스 중에 오류가 발생합니다.

szLogPath [in]

로그 파일이 복원될 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 경로는 DsRestoreGetDatabaseLocations 함수에서 제공되며 BFT 값은 BFT_LOG_DIR. 경로가 빈 디렉터리를 가리키는 경우 새 로그 파일이 만들어집니다. 이 매개 변수는 NULL일 수 없습니다.

rgrstmap [in]

각 데이터베이스에 대한 이전 경로와 새 경로를 포함하는 EDB_RSTMAP 구조체의 배열입니다. 각 데이터베이스에 대해 하나의 구조가 있습니다. 디렉터리의 경우 시스템 데이터베이스에 대한 구조와 디렉터리 데이터베이스에 대한 다른 구조가 있습니다. 배열의 요소 순서는 중요하지 않습니다. crstmap 매개 변수에는 배열의 요소 수가 포함됩니다.

crstmap [in]

rgrstmap 배열의 요소 수를 포함합니다.

szBackupLogPath [in]

백업된 로그 파일이 현재 있는 경로를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수는 NULL일 수 없습니다.

genLow [in]

이 복원 세션에서 복원할 가장 낮은 로그 번호를 포함합니다. 0x00000 범위에서 0xFFFFF 범위의 16진수입니다.

genHigh [in]

이 복원 세션에서 복원할 가장 높은 로그 번호를 포함합니다. 0x00000 범위에서 0xFFFFF 범위의 16진수입니다.

반환 값

함수가 성공하면 S_OK 반환하고, 그렇지 않으면 Win32 또는 RPC 오류 코드를 반환합니다. 다음 목록에는 가능한 오류 코드가 나열되어 있습니다.

ERROR_ACCESS_DENIED

호출자에게 이 함수를 호출할 수 있는 적절한 액세스 권한이 없습니다. DsSetAuthIdentity 함수를 사용하여 백업 및 복원 함수에 사용할 자격 증명을 설정할 수 있습니다.

ERROR_INVALID_PARAMETER

하나 이상의 매개 변수가 잘못되었습니다.

hrMissingExpiryToken

DsRestorePrepare에 제공된 만료 토큰이 잘못되었습니다. 이 값은 Ntdsbmsg.h에 정의되어 있습니다.

요구 사항

추가 정보

DsRestoreRegisterComplete

DsRestorePrepare

DsRestoreGetDatabaseLocations

DsRestoreEnd

EDB_RSTMAP

Active Directory 복원

디렉터리 백업 함수