API. JetGetAttachInfoInstance, méthode
Utilisé lors d’une sauvegarde initiée par JetBeginExternalBackupInstance (JET_INSTANCE, BeginExternalBackupGrbit) pour interroger une instance pour obtenir 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 qui sont actuellement attachées à l’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).
Espace de noms : Microsoft. ISAM. esent. Interop
Assembly : 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
instance
Type : Microsoft.ISAM.esent.Interop.JET_INSTANCEInstance pour laquelle obtenir les informations.
files
Type : System. StringRetourne une liste de chaînes terminées par le caractère null qui décrivent l’ensemble des fichiers de base de données qui doivent faire partie du jeu de fichiers de sauvegarde. La liste de chaînes retournée dans cette mémoire tampon est dans le même format qu’une chaîne multiple utilisée par le registre. Chaque chaîne se terminant par un caractère NULL est retournée dans la séquence suivie d’une marque de fin null finale.
maxChars
Type : System. Int32Nombre maximal de caractères à récupérer.
actualChars
Type : System. Int32Taille 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.