Api.JetGetLogInfoInstance-Methode

Wird während einer von JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) initiierten Sicherung verwendet, um einen instance nach den Namen von Datenbankpatchdateien und Protokolldateien abzufragen, die Teil des Sicherungsdateisatzes werden sollen. Diese Dateien können anschließend mithilfe von JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) geöffnet und mithilfe von 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 JetGetLogInfoInstance ( _
    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.JetGetLogInfoInstance(instance, _
    files, maxChars, actualChars)
public static void JetGetLogInfoInstance(
    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 Datenbankpatchdateien und Protokolldateien beschreibt, die Teil des Sicherungsdateisatzes sein sollten. Die Liste der in diesem Puffer zurückgegebenen Zeichenfolgen hat das gleiche Format wie eine mehrfache Zeichenfolge, die von der Registrierung verwendet wird. Jede NULL-beendete Zeichenfolge wird nacheinander zurückgegeben, gefolgt von einem abschließenden NULL-Abschlusszeichen.

  • maxChars
    Typ: System.Int32

    Maximale Anzahl der abzurufenden Zeichen.

  • actualChars
    Typ: System.Int32

    Tatsächliche Größe der Dateiliste. Wenn dieser 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