Метод Api.JetGetAttachInfoInstance

  • Статья

Используется во время резервного копирования, инициированного JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) для запроса экземпляра имен файлов базы данных, которые должны стать частью резервного набора файлов. Будут рассматриваться только базы данных, подключенные к экземпляру с помощью JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit). Эти файлы можно впоследствии открыть с помощью JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) и прочитать с помощью JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32)).

Пространство имен:Microsoft.Isam.Esent.Interop
Сборки: Microsoft.Isam.Esent.Interop (в Microsoft.Isam.Esent.Interop.dll)

Синтаксис

'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
)

Параметры

  • файлы
    Тип: System.String

    Возвращает список строк, завершаемых значением NULL, описывающих набор файлов базы данных, которые должны быть частью резервного набора файлов. Список строк, возвращаемых в этом буфере, имеет тот же формат, что и многостроковый, используемый реестром. Каждая строка, завершающаяся значением NULL, возвращается последовательно, за которой следует окончательный признак конца null.

  • maxChars
    Тип: System.Int32

    Максимальное количество извлекаемых символов.

  • actualChars
    Тип: System.Int32

    Фактический размер списка файлов. Если это значение больше, чем maxChars, то список был усечен.

Комментарии

Важно отметить, что этот API не возвращает ошибку или предупреждение, если выходной буфер слишком мал, чтобы принять полный список файлов, которые должны быть частью резервного набора файлов.

См. также раздел

Ссылка

Класс API

Члены API

Пространство имен Microsoft.Isam.Esent.Interop