Función DsBackupPrepare
[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 DsBackupPrepare prepara el directorio en el servidor especificado para la copia de seguridad en línea y devuelve un identificador de contexto de copia de seguridad usado en llamadas posteriores a otras funciones de copia de seguridad.
Sintaxis
HRESULT DsBackupPrepare(
_In_ LPCTSTR szBackupServer,
_In_ ULONG grbit,
_In_ ULONG btBackupType,
_Out_ PVOID *ppvExpiryToken,
_Out_ LPDWORD pcbExpiryTokenSize,
_Out_ HBC *phbc
);
Parámetros
-
szBackupServer [in]
-
Puntero a una cadena terminada en null que contiene el nombre del servidor que se va a realizar la copia de seguridad. Las barras diagonales inversas anteriores son opcionales. El servidor debe ser el mismo equipo desde el que se llama a esta función. El nombre del servidor no puede contener un carácter de subrayado (_). Un ejemplo de un nombre de servidor es "\\server1".
-
grbit [in]
-
Determina si se realizará una copia de seguridad de los archivos de registro. Este valor siempre debe ser 0 porque no se admiten copias de seguridad incrementales.
-
btBackupType [in]
-
Especifica el tipo de copia de seguridad. Puede ser uno de los siguientes valores.
-
BACKUP_TYPE_FULL
-
Especifica una copia de seguridad completa. Se realiza una copia de seguridad del directorio completo (DIT, archivos de registro y archivos de actualización). Se realiza una copia de seguridad de todos los datos y se truncan los archivos de registro de transacciones. Solo se admiten copias de seguridad completas.
-
BACKUP_TYPE_LOGS_ONLY
-
Este valor no se admite. Especifica que solo se realizará una copia de seguridad de los registros de base de datos y no de la propia base de datos. Normalmente se usa al realizar una copia de seguridad diferencial o incremental.
-
BACKUP_TYPE_INCREMENTAL
-
Este valor no se admite. DsBackupPrepare devuelve ERROR_INVALID_PARAMETER.
ppvExpiryToken [out]
Puntero a un valor PVOID que recibe un puntero a un token de expiración asociado a esta copia de seguridad. pcbExpiryTokenSize recibe el tamaño, en bytes, de estos datos. El autor de la llamada debe guardar el contenido de este token con la copia de seguridad porque el token debe pasarse a DsRestorePrepare al intentar restaurar los datos. Una vez almacenado el token y ya no es necesario, el autor de la llamada debe liberar la memoria asignada mediante DsBackupFree.
pcbExpiryTokenSize [out]
Puntero a un valor DWORD que recibe el tamaño, en bytes, del token en ppvExpiryToken.
phbc [out]
Puntero a un valor HBC que recibe el identificador de la copia de seguridad. Este identificador se usa al llamar a otras funciones de copia de seguridad del servicio de directorio, como DsBackupOpenFile y DsBackupEnd.
Valor devuelto
Devuelve S_OK si la función es correcta o un código de error de lo 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
-
szBackupServer o phbcBackupContext no son válidos.
-
ERROR_NOT_ENOUGH_MEMORY
-
Error de asignación de memoria.
-
hrCouldNotConnect
-
No se encontró el servidor de szBackupServer , no es un controlador de dominio o szBackupServer no tiene el formato correcto. Este valor se define en ntdsbmsg.h.
-
hrInvalidParam
-
ppvExpiryToken o pcbExpiryTokenSize no son válidos . Este valor se define en Ntdsbmsg.h.
-
RPC_S_INVALID_BINDING
-
La función se llama de forma remota o el servidor en szServerName no es un controlador de dominio.
Observaciones
Esta función requiere que el autor de la llamada tenga el privilegio SE_BACKUP_NAME . La función DsSetAuthIdentity se puede usar para cambiar el contexto de seguridad en el que se llama a esta función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DsBackupPrepareW (Unicode) y DsBackupPrepareA (ANSI) |