Compartir a través de

Método Api.JetGetAttachInfoInstance

  • Artículo

Se usa durante una copia de seguridad iniciada por JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) 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 que están asociadas actualmente a la instancia mediante JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit ). Estos archivos se pueden abrir posteriormente mediante JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) y leer con JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32).

Espacio de nombres:Microsoft.Isam.Esent.Interop
Ensamblaje: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Sintaxis

'Declaration
Public Shared Sub JetGetAttachInfoInstance ( _
    instance As JET_INSTANCE, _
    <OutAttribute> ByRef files As String, _
    maxChars As Integer, _
    <OutAttribute> ByRef actualChars As Integer _
)
'Usage
Dim instance As JET_INSTANCE
Dim files As String
Dim maxChars As Integer
Dim actualChars As IntegerApi.JetGetAttachInfoInstance(instance, _
    files, maxChars, actualChars)

public static void JetGetAttachInfoInstance(
    JET_INSTANCE instance,
    out string files,
    int maxChars,
    out int actualChars
)

Parámetros

  • files
    Tipo: System.String

    Devuelve una 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.

  • maxChars
    Tipo: System.Int32

    Número máximo de caracteres que se van a recuperar.

  • actualChars
    Tipo: System.Int32

    Tamaño real de la lista de archivos. Si es mayor que maxChars, la lista se ha truncado.

Observaciones

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.

Vea también

Referencia

Clase de API

Miembros de api

Espacio de nombres Microsoft.Isam.Esent.Interop