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 (in 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 命名空間