Función DsRestoreGetDatabaseLocations
[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 DsRestoreGetDatabaseLocations obtiene las ubicaciones donde se deben copiar los archivos de copia de seguridad durante una operación de restauración.
Sintaxis
HRESULT DsRestoreGetDatabaseLocations(
_In_ HBC hbc,
_Out_ LPWSTR *pszDatabaseLocationList,
_Out_ LPDWORD pcbSize
);
Parámetros
-
hbc [in]
-
Contiene el identificador de contexto de restauración obtenido con la función DsRestorePrepare .
-
pszDatabaseLocationList [out]
-
Puntero a un puntero de cadena que recibe la lista de ubicaciones de base de datos como rutas unc. Esta lista recibe una lista de cadenas terminadas en null dobles de cadenas terminadas en NULL únicas.
La función DsRestoreGetDatabaseLocations 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. La función DsRestoreGetDatabaseLocations solo proporciona los siguientes tipos de nombre.
-
BFT_NTDS_DATABASE
-
El archivo de base de datos NTDS debe copiarse en este archivo. Este es el archivo que se identificó como BFT_NTDS_DATABASE cuando se realizó la copia de seguridad.
-
BFT_LOG_DIR
-
Todos los archivos de registro se copian en este directorio. Los archivos de registro se identificaron como BFT_LOG cuando se realizó la copia de seguridad.
-
BFT_CHECKPOINT_DIR
-
Todos los archivos de revisión se copian en este directorio. Los archivos de revisión se identificaron como BFT_PATCH_FILE cuando se realizó la copia de seguridad.
pcbSize [out]
Puntero al valor DWORD que recibe el tamaño, en bytes, del búfer pszDatabaseLocationList .
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 los posibles códigos de error.
-
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, pszDatabaseLocationList o pcbSize no son válidos .
-
ERROR_NOT_ENOUGH_MEMORY
-
Error de asignación de memoria.
Comentarios
La función DsRestoreGetDatabaseLocations se puede usar para obtener los directorios de restauración sin acceso a los datos de copia de seguridad. Para ello, llame a DsRestorePrepare con NULL para el parámetro pvExpiryToken . Esto hace que DsRestorePrepare devuelva un identificador de contexto restringido que solo se puede usar con la función DsRestoreGetDatabaseLocations .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|
| Nombres Unicode y ANSI |
DsRestoreGetDatabaseLocationsW (Unicode) y DsRestoreGetDatabaseLocationsA (ANSI) |