Función DsBackupGetDatabaseNames
[Esta función está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. A partir de Windows Vista, use el Servicio de instantáneas de volumen (VSS) en su lugar.
La función DsBackupGetDatabaseNames obtiene la lista de archivos de base de datos de los que se va a realizar una copia de seguridad para el contexto de copia de seguridad especificado.
Sintaxis
HRESULT DsBackupGetDatabaseNames(
_In_ HBC hbc,
_Out_ LPTSTR *pszAttachmentInfo,
_Out_ LPDWORD pcbSize
);
Parámetros
-
hbc [in]
-
Contiene el identificador de contexto de copia de seguridad obtenido con la función DsBackupPrepare .
-
pszAttachmentInfo [out]
-
Puntero a un puntero de cadena que recibe la lista de nombres de archivo de base de datos como rutas unc. Este valor debe inicializarse en NULL antes de llamar a DsBackupGetDatabaseNames.
Esta lista recibe una lista de cadenas terminadas en null dobles de cadenas terminadas en NULL únicas.
La función DsBackupGetDatabaseNames asigna este búfer y debe liberarse cuando ya no sea necesario llamando a la función DsBackupFree .
El primer carácter de cada nombre de archivo contiene una de las constantes BFT que identifica el tipo de nombre. La función DsRestoreGetDatabaseLocations solo proporciona los siguientes tipos de nombres.
-
BFT_NTDS_DATABASE
-
El archivo es un archivo de base de datos NTDS. Este archivo se debe copiar en el archivo identificado como BFT_NTDS_DATABASE cuando se restauran los datos.
-
BFT_LOG
-
El archivo es un archivo de registro. Todos los archivos de registro se copian en el directorio identificado como BFT_LOG_DIR cuando se restauran los datos.
-
BFT_PATCH_FILE
-
El archivo es un archivo de revisión. Todos los archivos de revisión se copian en el directorio identificado como BFT_CHECKPOINT_DIR cuando se restauran los datos.
pcbSize [out]
Puntero al valor DWORD que recibe el tamaño, en bytes, del búfer pszAttachmentInfo .
Valor devuelto
Devuelve S_OK si la función es correcta o un código de error Win32 o RPC en caso contrario. En la lista siguiente se enumeran otros códigos de error posibles.
-
ERROR_ACCESS_DENIED
-
El autor de la llamada no tiene los privilegios de acceso adecuados para llamar a esta función. La función DsSetAuthIdentity se puede usar para establecer las credenciales que se usarán para las funciones de copia de seguridad y restauración.
-
ERROR_INVALID_PARAMETER
-
hbc, pszAttachmentInfo o pcbSize no son válidos .
-
ERROR_NOT_ENOUGH_MEMORY
-
Error de asignación de memoria.
Comentarios
La función DsBackupGetDatabaseNames proporciona una lista de los archivos de base de datos necesarios para una copia de seguridad. Una copia de seguridad completa consta de los archivos de base de datos y los archivos de registro proporcionados por la función DsBackupGetBackupLogs . No se admiten copias de seguridad incrementales de servidores de Active Directory.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DsBackupGetDatabaseNamesW (Unicode) y DsBackupGetDatabaseNamesA (ANSI) |