Método Api.JetGetAttachInfoInstance

  • Artigo

Usado durante um backup iniciado por JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) para consultar uma instância dos nomes dos arquivos de banco de dados que devem se tornar parte do conjunto de arquivos de backup. Somente os bancos de dados que estão atualmente anexados à instância usando JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) serão considerados. Esses arquivos podem ser abertos posteriormente usando JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) e lidos usando JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32).

Namespace:Microsoft.Isam.Esent.Interop
Assembly: Microsoft.Isam.Esent.Interop (em Microsoft.Isam.Esent.Interop.dll)

Sintaxe

'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

    Retorna uma lista de cadeias de caracteres terminadas em nulo que descrevem o conjunto de arquivos de banco de dados que deve fazer parte do conjunto de arquivos de backup. A lista de cadeias de caracteres retornadas nesse buffer está no mesmo formato de uma cadeia de caracteres múltipla usada pelo Registro. Cada cadeia de caracteres terminada em nulo é retornada em sequência seguida por um terminador nulo final.

  • maxChars
    Tipo: System.Int32

    Número máximo de caracteres a serem recuperados.

  • actualChars
    Tipo: System.Int32

    Tamanho real da lista de arquivos. Se for maior que maxChars, a lista será truncada.

Comentários

É importante observar que essa API não retornará um erro ou aviso se o buffer de saída for muito pequeno para aceitar a lista completa de arquivos que devem fazer parte do conjunto de arquivos de backup.

Confira também

Referência

Classe API

Membros da API

Namespace Microsoft.Isam.Esent.Interop