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 |
헤더 |
|
라이브러리 |
|
DLL |
|