영어로 읽기

다음을 통해 공유


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 서버 백업

디렉터리 백업 함수