Función JetGetAttachInfo

Se aplica a: Windows | Windows Server

Función JetGetAttachInfo

La función JetGetAttachInfo se usa durante una copia de seguridad iniciada por JetBeginExternalBackup para consultar una instancia de los nombres de los archivos de base de datos que deben formar parte del conjunto de archivos de copia de seguridad. Solo se considerarán las bases de datos asociadas actualmente a la instancia mediante JetAttachDatabase . Estos archivos se pueden abrir posteriormente mediante JetOpenFile y leerlos mediante JetReadFile.

    JET_ERR JET_API JetGetAttachInfo(
      __out_opt     tchar* szz,
      __in          unsigned long cbMax,
      __out_opt     unsigned long* pcbActual
    );

Parámetros

Szz

Búfer de salida que recibe la lista de cadenas terminadas en null que describen el conjunto de archivos de base de datos que deben formar parte del conjunto de archivos de copia de seguridad. La lista de cadenas devueltas en este búfer tiene el mismo formato que una cadena múltiple usada por el Registro. Cada cadena terminada en null se devuelve en secuencia seguida de un terminador nulo final.

cbMax

Tamaño máximo en bytes del búfer de salida.

pcbActual

Puntero al búfer de salida que recibió la cantidad real de datos de cadena.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errBackupAbortByServer	Error en la operación porque la copia de seguridad externa actual se ha anulado mediante una llamada a JetStopBackup. Windows XP solo devolverá este error y versiones posteriores.
JET_errClientRequestToStopJetService	No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService.
JET_errInstanceUnavailable	No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos. Windows XP solo devolverá este error y versiones posteriores.
JET_errInvalidBackupSequence	Error en la operación de copia de seguridad porque se ha llamado fuera de secuencia. JetGetAttachInfo devolverá este error si la copia de seguridad actual no es una copia de seguridad completa.
JET_errInvalidParameter	Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. Esto puede ocurrir para JetGetAttachInfo cuando el identificador de instancia especificado no es válido (Windows XP y versiones posteriores).
JET_errNoBackup	Error en la operación porque no hay ninguna copia de seguridad externa en curso.
JET_errNotInitialized	No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errRestoreInProgress	No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión.
JET_errRunningInMultiInstanceMode	Error en la operación porque se intentó usar el motor en modo heredado (modo de compatibilidad de Windows 2000), donde solo se admite una instancia cuando ya existen varias instancias.
JET_errTermInProgress	No es posible completar la operación porque se está cerrando la instancia asociada a la sesión.

Si se ejecuta correctamente, la información solicitada sobre el conjunto de archivos de base de datos que debe formar parte del conjunto de archivos de copia de seguridad se colocará en los búferes de salida en los que se proporciona.

En caso de error, el estado de los búferes de salida no está definido. El error provocará la cancelación de todo el proceso de copia de seguridad de la instancia.

Comentarios

Es importante tener en cuenta que esta API no devuelve un error o advertencia si el búfer de salida es demasiado pequeño para aceptar la lista completa de archivos que deben formar parte del conjunto de archivos de copia de seguridad. La aplicación siempre debe proporcionar un búfer para recibir el tamaño real de esta lista y usar esa información para determinar si la lista se ha truncado.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetGetAttachInfoW (Unicode) y JetGetAttachInfoA (ANSI).

Consulte también

JET_ERR
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackup
JetOpenFile
JetReadFile
JetStopBackup
JetStopService