DsRestorePrepare 함수
[이 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista부터 VSS(볼륨 섀도 복사본 서비스) 를 대신 사용합니다.]
DsRestorePrepare 함수는 지정된 디렉터리 서버에 연결하여 복원 작업을 준비합니다.
구문
HRESULT DsRestorePrepare(
_In_ LPCWSTR szServerName,
_In_ ULONG rtFlag,
_In_ PVOID pvExpiryToken,
_In_ DWORD cbExpiryTokenSize,
_Out_ HBC *phbc
);
매개 변수
-
szServerName [in]
-
복원할 서버의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다. 앞의 백 슬래시는 선택 사항입니다. 서버는 이 함수가 호출된 컴퓨터와 동일해야 합니다. 서버 이름에는 밑줄(_) 문자를 포함할 수 없습니다. 서버 이름의 예는 "\\server1"입니다.
-
rtFlag [in]
-
수행할 복원 유형을 지정합니다. 이 값은 0이거나 다음 값 중 하나일 수 있습니다.
-
RESTORE_TYPE_CATCHUP
-
기본값 복원된 버전은 복원된 DIT가 다른 엔터프라이즈 서버 컴퓨터와 동기화될 수 있도록 표준 조정 논리를 통해 조정됩니다.
-
RESTORE_TYPE_AUTHORATATIVE
-
지원되지 않습니다.
-
RESTORE_TYPE_ONLINE
-
지원되지 않습니다. 복원은 NTDS가 온라인 상태일 때 수행됩니다.
pvExpiryToken [in]
복원 중인 백업과 연결된 만료 토큰에 대한 포인터입니다. 이 토큰은 디렉터리가 백업되었을 때 DsBackupPrepare 함수에서 가져옵니다.
이 매개 변수가 NULL인 경우 phbc 에서 반환된 핸들은 DsRestoreGetDatabaseLocations 함수를 사용하여 복원 디렉터리를 가져오는 데만 사용할 수 있습니다. 핸들은 다른 복원 함수에 사용할 수 없습니다.
cbExpiryTokenSize [in]
pvExpiryToken의 만료 토큰 크기(바이트)를 포함합니다.
phbc [out]
복원 핸들을 받는 HBC 값에 대한 포인터입니다. 이 핸들은 DsBackupOpenFile 및 DsRestoreEnd와 같은 다른 디렉터리 서비스 복원 함수를 호출할 때 사용됩니다.
반환 값
성공하면 표준 HRESULT 코드를 반환합니다. 그렇지 않으면 오류 코드가 반환됩니다.
설명
DsRestorePrepare 함수를 사용하려면 호출자가 서버의 Administrators 그룹의 구성원이되어야 합니다.
DsRestorePrepare 는 제공된 토큰의 유무에 관계없이 사용할 수 있습니다. 토큰이 제공되면 만료가 확인되고 반환된 컨텍스트에서 모든 작업이 허용됩니다. 토큰이 제공되지 않으면 반환된 컨텍스트가 제한되며 DsRestoreGetDatabaseLocations 함수에만 사용할 수 있습니다. DsRestoreRegister 함수에는 사용할 수 없습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|
| 유니코드 및 ANSI 이름 |
DsRestorePrepareW (유니코드) 및 DsRestorePrepareA (ANSI) |