Función DsBackupGetBackupLogs
[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 DsBackupGetBackupLogs obtiene la lista de archivos de registro de los que se debe realizar una copia de seguridad para el contexto de copia de seguridad especificado.
Sintaxis
HRESULT DsBackupGetBackupLogs(
_In_ HBC hbc,
_Out_ LPTSTR *pszBackupLogFiles,
_Out_ LPDWORD pcbSize
);
Parámetros
-
hbc [in]
-
Contiene el identificador de contexto de copia de seguridad obtenido con la función DsBackupPrepare .
-
pszBackupLogFiles [out]
-
Puntero a un puntero de cadena que recibe la lista de nombres de archivo de registro como rutas UNC. Inicialice este valor en NULL antes de llamar a DsBackupGetBackupLogs.
Esta lista recibe una lista doble terminada en null de cadenas terminadas en null únicas.
La función DsBackupGetBackupLogs asigna este búfer y debe liberarse cuando ya no sea necesario llamando a la función DsBackupFree .
El primer carácter de cada uno de los nombres de archivo contiene una de las constantes BFT que identifica el tipo de nombre.
-
pcbSize [out]
-
Puntero al valor DWORD que recibe el tamaño, en bytes, del búfer pszBackupLogFiles .
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 posibles códigos de error.
-
ERROR_ACCESS_DENIED
-
El llamador 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, pszBackupLogFiles o pcbSize no es válido.
-
ERROR_NOT_ENOUGH_MEMORY
-
Error de asignación de memoria.
Comentarios
La función DsBackupGetBackupLogs proporciona una lista de los archivos de registro necesarios para una copia de seguridad. Una copia de seguridad completa consta de los archivos de base de datos proporcionados por la función DsBackupGetDatabaseNames y los archivos de registro. 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 |
DsBackupGetBackupLogsW (Unicode) y DsBackupGetBackupLogsA (ANSI) |