DsBackupGetBackupLogs 함수

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

DsBackupGetBackupLogs 함수는 지정된 백업 컨텍스트에 대해 백업해야 하는 로그 파일 목록을 가져옵니다.

구문

HRESULT DsBackupGetBackupLogs(
  _In_  HBC     hbc,
  _Out_ LPTSTR  *pszBackupLogFiles,
  _Out_ LPDWORD pcbSize
);

매개 변수

hbc [in]

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

pszBackupLogFiles [out]

로그 파일 이름 목록을 UNC 경로로 수신하는 문자열 포인터에 대한 포인터입니다. DsBackupGetBackupLogs를 호출하기 전에 이 값을 NULL로 초기화합니다.

이 목록은 null로 끝나는 단일 문자열의 이중 null 종료 목록을 받습니다.

이 버퍼는 DsBackupGetBackupLogs 함수에 의해 할당되며 DsBackupFree 함수를 호출하여 더 이상 필요하지 않은 경우 해제되어야 합니다.

각 파일 이름의 첫 번째 문자에는 이름 유형을 식별하는 BFT 상수 중 하나가 포함됩니다.

pcbSize [out]

pszBackupLogFiles 버퍼의 크기(바이트)를 수신하는 DWORD 값에 대한 포인터입니다.

반환 값

함수가 성공하거나 Win32 또는 RPC 오류 코드가 성공하면 S_OK 반환합니다. 다음 목록에는 다른 가능한 오류 코드가 나열되어 있습니다.

ERROR_ACCESS_DENIED

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

ERROR_INVALID_PARAMETER

hbc, pszBackupLogFiles 또는 pcbSize 가 잘못되었습니다.

ERROR_NOT_ENOUGH_MEMORY

메모리 할당 오류가 발생했습니다.

설명

DsBackupGetBackupLogs 함수는 백업에 필요한 로그 파일 목록을 제공합니다. 전체 백업은 DsBackupGetDatabaseNames 함수에서 제공하는 데이터베이스 파일과 로그 파일로 구성됩니다. Active Directory 서버의 증분 백업은 지원되지 않습니다.

요구 사항

추가 정보

DsBackupFree

DsBackupGetDatabaseNames

BFT 상수

Active Directory 서버 백업

디렉터리 백업 함수