Méthode Api.JetGetAttachInfoInstance

  • Article

Utilisé lors d’une sauvegarde lancée par JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) pour interroger un instance les noms des fichiers de base de données qui doivent faire partie du jeu de fichiers de sauvegarde. Seules les bases de données actuellement attachées au instance à l’aide de JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) sont prises en compte. Ces fichiers peuvent ensuite être ouverts à l’aide de JetOpenFileInstance(JET_INSTANCE, String, JET_HANDLE, Int64, Int64) et lus à l’aide de JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32) .

Namespace:Microsoft.Isam.Esent.Interop
Assemblée: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Syntaxe

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

Paramètres

  • files
    Type : System.String

    Retourne une liste de chaînes terminées par null décrivant l’ensemble de fichiers de base de données qui doivent faire partie du jeu de fichiers de sauvegarde. La liste des chaînes retournées dans cette mémoire tampon est au même format qu’une chaîne multiple utilisée par le Registre. Chaque chaîne terminée par null est retournée dans l’ordre, suivie d’un terminateur Null final.

  • maxChars
    Type : System.Int32

    Nombre maximal de caractères à récupérer.

  • actualChars
    Type : System.Int32

    Taille réelle de la liste de fichiers. Si cette valeur est supérieure à maxChars, la liste a été tronquée.

Notes

Il est important de noter que cette API ne retourne pas d’erreur ou d’avertissement si la mémoire tampon de sortie est trop petite pour accepter la liste complète des fichiers qui doivent faire partie du jeu de fichiers de sauvegarde.

Voir aussi

Informations de référence

Classe API

Membres de l’API

Espace de noms Microsoft.Isam.Esent.Interop