Installer.OpenDatabase メソッド

Installer オブジェクトの OpenDatabase メソッドでは、既存のデータベースを開くか、新しいデータベースを作成して、Database オブジェクトを返します。 Database オブジェクトを正常に作成して開くことができない場合は、エラーが生成されます。

構文

Installer.OpenDatabase(
  name,
  openMode
)

パラメーター

name

データベースのパス名を表す必須の文字列。 空の文字列を指定すると、永続化されていない一時データベースが作成されます。

openMode

次のリストのパラメーター、またはコミット時に書き込まれる新しい出力データベース ファイルのパス名を表す文字列。

パラメーター	意味
msiOpenDatabaseModeReadOnly 0	データベースを読み取り専用で開き、永続的な変更は行いません。
msiOpenDatabaseModeTransact 1	トランザクション モードで読み取り/書き込み可能なデータベースを開きます。
msiOpenDatabaseModeDirect 2	トランザクションなしで直接読み取り/書き込み可能なデータベースを開きます。
msiOpenDatabaseModeCreate 3	新しいデータベースを、読み取り/書き込み可能なトランザクション モードで作成します。
msiOpenDatabaseModeCreateDirect 4	新しいデータベースを、読み取り/書き込み可能なダイレクト モードで作成します。
msiOpenDatabaseModeListScript 5	データベースを開き、CreateAdvertiseScript メソッドによって生成されたファイルなどのアドバタイズ スクリプト ファイルを表示します。
msiOpenDatabaseModePatchFile 32	パッチ ファイルを指定するには、このフラグを追加します。

 

戻り値

開かれた既存または新規のインストーラー データベースを表す Database オブジェクト。

解説

データベースが別のデータベースの出力として開かれた場合、その出力データベースの概要情報ストリームは、実際には元のデータベースの読み取り専用のミラーであるため、変更できません。 さらに、データベースでは永続化されません。 出力データベースの概要情報を作成または変更するには、いったん閉じて、再び開く必要があります。

データベースに変更を加えて保存するには、まずトランザクション モード (msiOpenDatabaseModeTransact)、作成モード (msiOpenDatabaseModeCreate または msiOpenDatabaseModeCreateDirect)、またはダイレクト モード (msiOpenDatabaseModeDirect) でデータベースを開きます。 変更を行った後は、データベース ハンドルを閉じる前に必ず Commit メソッドを呼び出します。 Commit メソッドによって、すべてのバッファーがフラッシュされます。

ダイレクト モード (msiOpenDatabaseModeDirect または msiOpenDatabaseModeCreateDirect) で開かれているデータベースでは、データベースを閉じる前に必ず Commit メソッドを呼び出します。 これを行わないと、データベースが破損する可能性があります。

OpenDatabase メソッドはデータベース アクセスを開始するため、実行中のインストールでは使用できません。

メソッドが失敗した場合は、LastErrorRecord メソッドを使用して拡張エラー情報を取得できます。

必要条件