Api.JetGetAttachInfoInstance メソッド

JetBeginExternalBackupInstance(JET_INSTANCE, BeginExternalBackupGrbit) によって開始されたバックアップ中に、バックアップ ファイル セットの一部となるデータベース ファイルの名前をインスタンスに照会するために使用されます。 JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) を使用してインスタンスに現在アタッチされているデータベースのみが考慮されます。 これらのファイルは、その後 、JetOpenFileInstance(JET_INSTANCE、String、JET_HANDLE、Int64、Int64) を使用して開き、 JetReadFileInstance(JET_INSTANCE, JET_HANDLE, [], Int32, Int32) を使用して読み取ります。

Namespace:Microsoft.Isam.Esent.Interop
アセンブリ： Microsoft.Isam.Esent.Interop (Microsoft.Isam.Esent.Interop.dll)

構文

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

パラメーター

• instance
  種類: Microsoft.Isam.Esent.Interop.JET_INSTANCE

  情報を取得するインスタンス。

• files
  型: System.String

  バックアップ ファイル セットの一部である必要があるデータベース ファイルのセットを説明する null で終わる文字列の一覧を返します。 このバッファーで返される文字列の一覧は、レジストリで使用される複数文字列と同じ形式です。 null で終わる各文字列は、順番に返され、その後に最後の null 終端文字が返されます。

• maxChars
  型: System.Int32

  取得する最大文字数。

• actualChars
  型: System.Int32

  ファイル リストの実際のサイズ。 これが maxChars より大きい場合、リストは切り捨てられます。

解説

出力バッファーが小さすぎてバックアップ ファイル セットの一部である必要があるファイルの完全な一覧を受け入れない場合、この API はエラーまたは警告を返さないことを注意してください。

関連項目

リファレンス

Api クラス

API メンバー

Microsoft.Isam.Esent.Interop 名前空間