다음을 통해 공유

DsBackupRead 함수

  • 아티클

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

DsBackupRead 함수는 현재 열려 있는 파일에서 버퍼로 데이터 블록을 읽습니다. 클라이언트 애플리케이션은 전체 백업 파일을 받을 때까지 이 함수를 반복적으로 호출해야 합니다. DsBackupOpenFile 함수는 백업 파일의 전체 크기를 제공합니다.

구문

HRESULT DsBackupRead(
  _In_  HBC    hbc,
  _In_  PVOID  pvBuffer,
  _In_  DWORD  cbBuffer,
  _Out_ PDWORD pcbRead
);

매개 변수

hbc [in]

DsBackupPrepare 함수를 사용하여 가져온 백업 컨텍스트 핸들을 포함합니다.

pvBuffer [in]

데이터를 수신하는 버퍼에 대한 포인터입니다. 이 버퍼의 크기는 cbBuffer 바이트 이상이어야 합니다.

cbBuffer [in]

pvBuffer에서 버퍼의 크기(바이트)를 포함합니다. 이 값은 8192의 배수여야 하며 24576보다 크거나 같아야 합니다.

pcbRead [out]

읽은 실제 바이트 수를 수신하는 DWORD 값에 대한 포인터입니다. 일부 전송은 전체 버퍼를 데이터로 채우는 대신 전송되는 버퍼를 조각화하기 때문에 요청된 바이트 수보다 적을 수 있습니다.

반환 값

함수가 성공하면 S_OK 반환하고, 그렇지 않으면 Win32 또는 RPC 오류 코드를 반환합니다. 가능한 오류 코드에는 다음이 포함됩니다.

ERROR_INVALID_PARAMETER

하나 이상의 매개 변수가 유효하지 않습니다.

ERROR_HANDLE_EOF

백업 파일의 끝에 도달했습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
Ntdsbcli.h
라이브러리
Ntdsbcli.lib
DLL
Ntdsbcli.dll

추가 정보

DsBackupOpenFile

DsBackupPrepare

DsBackupFree

Active Directory 서버 백업

디렉터리 백업 함수