DsBackupGetDatabaseNames 함수
[이 함수는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. Windows Vista부터 VSS(볼륨 섀도 복사본 서비스) 를 대신 사용합니다.]
DsBackupGetDatabaseNames 함수는 지정된 백업 컨텍스트에 대해 백업할 데이터베이스 파일 목록을 가져옵니다.
구문
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
매개 변수
-
hbc [in]
-
DsBackupPrepare 함수를 사용하여 가져온 백업 컨텍스트 핸들을 포함합니다.
-
pszAttachmentInfo [out]
-
데이터베이스 파일 이름 목록을 UNC 경로로 수신하는 문자열 포인터에 대한 포인터입니다. DsBackupGetDatabaseNames를 호출하기 전에 이 값을 NULL로 초기화해야 합니다.
이 목록은 null로 끝나는 단일 문자열의 이중 null 종료 목록을 받습니다.
이 버퍼는 DsBackupGetDatabaseNames 함수에 의해 할당되며 DsBackupFree 함수를 호출하여 더 이상 필요하지 않은 경우 해제해야 합니다.
각 파일 이름의 첫 번째 문자에는 이름 유형을 식별하는 BFT 상수 중 하나가 포함됩니다. DsRestoreGetDatabaseLocations 함수는 다음 유형의 이름만 제공합니다.
-
BFT_NTDS_DATABASE
-
파일은 NTDS 데이터베이스 파일입니다. 이 파일은 데이터가 복원될 때 BFT_NTDS_DATABASE 식별된 파일에 복사해야 합니다.
-
BFT_LOG
-
파일이 로그 파일입니다. 모든 로그 파일은 데이터가 복원될 때 BFT_LOG_DIR 식별된 디렉터리에 복사됩니다.
-
BFT_PATCH_FILE
-
파일은 패치 파일입니다. 모든 패치 파일은 데이터가 복원될 때 BFT_CHECKPOINT_DIR 식별된 디렉터리에 복사됩니다.
pcbSize [out]
pszAttachmentInfo 버퍼의 크기(바이트)를 수신하는 DWORD 값에 대한 포인터입니다.
반환 값
함수가 성공하면 S_OK 반환하고, 그렇지 않으면 Win32 또는 RPC 오류 코드를 반환합니다. 다음 목록에는 다른 가능한 오류 코드가 나열되어 있습니다.
-
ERROR_ACCESS_DENIED
-
호출자에게 이 함수를 호출할 수 있는 적절한 액세스 권한이 없습니다. DsSetAuthIdentity 함수를 사용하여 백업 및 복원 함수에 사용할 자격 증명을 설정할 수 있습니다.
-
ERROR_INVALID_PARAMETER
-
hbc, pszAttachmentInfo 또는 pcbSize 가 잘못되었습니다.
-
ERROR_NOT_ENOUGH_MEMORY
-
메모리 할당 오류가 발생했습니다.
설명
DsBackupGetDatabaseNames 함수는 백업에 필요한 데이터베이스 파일 목록을 제공합니다. 전체 백업은 데이터베이스 파일과 DsBackupGetBackupLogs 함수에서 제공하는 로그 파일로 구성됩니다. Active Directory 서버의 증분 백업은 지원되지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista |
| 지원되는 최소 서버 |
Windows Server 2008 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|
| 유니코드 및 ANSI 이름 |
DsBackupGetDatabaseNamesW (유니코드) 및 DsBackupGetDatabaseNamesA (ANSI) |