Api.JetGetAttachInfoInstance-Methode

  • Artikel

Wird während einer von JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) initiierten Sicherung verwendet, um einen instance nach den Namen der Datenbankdateien abzufragen, die Teil des Sicherungsdateisatzes werden sollen. Es werden nur Datenbanken berücksichtigt, die derzeit mit JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) an den instance angefügt sind. Diese Dateien können anschließend mit JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) geöffnet und mit JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32) gelesen werden.

Namespace:Microsoft.Isam.Esent.Interop
Versammlung: Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

Syntax

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

Parameter

  • files
    Typ: System.String

    Gibt eine Liste mit null beendeten Zeichenfolgen zurück, die den Satz von Datenbankdateien beschreibt, die Teil des Sicherungsdateisatzes sein sollten. Die Liste der in diesem Puffer zurückgegebenen Zeichenfolgen hat das gleiche Format wie eine von der Registrierung verwendete Mehrzeichenfolge. Jede NULL-Zeichenfolge wird nacheinander zurückgegeben, gefolgt von einem abschließenden NULL-Abschlussator.

  • maxChars
    Typ: System.Int32

    Maximale Anzahl der abzurufenden Zeichen.

  • actualChars
    Typ: System.Int32

    Tatsächliche Größe der Dateiliste. Wenn dies größer als maxChars ist, wurde die Liste abgeschnitten.

Bemerkungen

Beachten Sie, dass diese API keinen Fehler oder eine Warnung zurückgibt, wenn der Ausgabepuffer zu klein ist, um die vollständige Liste der Dateien zu akzeptieren, die Teil des Sicherungsdateisatzes sein sollten.

Siehe auch

Verweis

Api-Klasse

API-Member

Microsoft.Isam.Esent.Interop-Namespace