다음을 통해 공유

DsBackupOpenFile 함수

  • 아티클

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

DsBackupOpenFile 함수는 지정된 파일을 열고 백업을 위해 파일을 준비하는 데 필요한 클라이언트 및 서버 작업을 수행합니다.

구문

HRESULT DsBackupOpenFile(
  _In_  HBC           hbc,
  _In_  LPCTSTR       szAttachmentName,
  _In_  DWORD         cbReadHintSize,
  _Out_ LARGE_INTEGER *pliFileSize
);

매개 변수

hbc [in]

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

szAttachmentName [in]

열 백업 파일의 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

cbReadHintSize [in]

DsBackupRead 함수에서 pvBuffer 인수로 전달된 버퍼의 가능한 크기(바이트)를 포함합니다. 백업 함수는 이 값을 힌트로 사용하여 네트워크 트래픽을 최적화합니다. 이 값은 8192의 배수여야 하며 24576보다 크거나 같아야 합니다.

pliFileSize [out]

열린 백업 파일의 크기(바이트)를 수신하는 LARGE_INTEGER 값에 대한 포인터입니다.

반환 값

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

ERROR_ACCESS_DENIED

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

ERROR_INVALID_PARAMETER

hbc, szAttachmentName 또는 pliFileSize 가 잘못되었습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows Vista
지원되는 최소 서버
 Windows Server 2008
헤더
Ntdsbcli.h
라이브러리
Ntdsbcli.lib
DLL
Ntdsbcli.dll
유니코드 및 ANSI 이름
 DsBackupOpenFileW (유니코드) 및 DsBackupOpenFileA (ANSI)

추가 정보

DsBackupRead

Active Directory 서버 백업

디렉터리 백업 함수