Méthode Api.JetGetAttachInfoInstance
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
instance
Type : Microsoft.Isam.Esent.Interop.JET_INSTANCELe instance pour obtenir les informations.
files
Type : System.StringRetourne 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.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.