次の方法で共有


MsiOpenDatabaseA 関数 (msiquery.h)

MsiOpenDatabase 関数は、データ アクセス用のデータベース ファイルを開きます。 この関数は、MsiCloseHandleを使用して閉じる必要があるハンドルを返します。

構文

UINT MsiOpenDatabaseA(
  [in]  LPCSTR    szDatabasePath,
  [in]  LPCSTR    szPersist,
  [out] MSIHANDLE *phDatabase
);

パラメーター

[in] szDatabasePath

データベース ファイルへの完全パスまたは相対パスを指定します。

[in] szPersist

ファイルまたは永続化モードへの完全パスを受け取ります。 szPersist パラメーターを使用すると、永続的な出力を新しいファイルに転送したり、次の定義済みの永続化モードのいずれかを指定できます。

価値 意味
MSIDBOPEN_CREATEDIRECT
新しいデータベースを作成し、直接モードで読み取り/書き込みを行います。
MSIDBOPEN_CREATE
新しいデータベースを作成し、トランザクション モードの読み取り/書き込みを行います。
MSIDBOPEN_DIRECT
トランザクションなしでデータベースの直接読み取り/書き込みを開きます。
MSIDBOPEN_READONLY
データベースを読み取り専用で開きます。永続的な変更はありません。
MSIDBOPEN_TRANSACT
トランザクション モードでデータベースの読み取り/書き込みを開きます。
MSIDBOPEN_PATCHFILE
このフラグを追加して、パッチ ファイルを示します。

[out] phDatabase

返されたデータベース ハンドルの場所へのポインター。

戻り値

MsiOpenDatabase 関数は、次の値を返します。

備考

データベースに変更を加えて保存するには、まず、トランザクション (MSIDBOPEN_TRANSACT)、作成 (MSIDBOPEN_CREATEまたはMSIDBOPEN_CREATEDIRECT)、または直接 (MSIDBOPEN_DIRECT) モードでデータベースを開きます。 変更を行った後、データベース ハンドルを閉じる前 MsiDatabaseCommit を常に呼び出します。 MsiDatabaseCommit はすべてのバッファーをフラッシュします。

データベース ハンドルを閉じる前に、直接モード (MSIDBOPEN_DIRECTまたはMSIDBOPEN_CREATEDIRECT) で開かれたデータベースで MsiDatabaseCommit を常に呼び出します。 これを行わないと、データベースが破損する可能性があります。

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

PMSIHANDLE 型の変数は、インストーラーがスコープ外に出ると PMSIHANDLE オブジェクトを閉じるのに対し、MSICloseHandleを呼び出して MSIHANDLE オブジェクト 閉じる必要があるため、PMSIHANDLE 型の変数を使用することをお勧めします。 詳細については、「Windows インストーラーのベスト プラクティス」の「HANDLE の代わりに PMSIHANDLE を使用する 」を参照してください。

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

手記

msiquery.h ヘッダーは、MSIOpenDatabase をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows Server 2012、Windows 8、Windows Server 2008 R2、または Windows 7 の Windows インストーラー 5.0。 Windows Server 2008 または Windows Vista の Windows インストーラー 4.0 または Windows インストーラー 4.5。 Windows Server 2003 または Windows XP の Windows インストーラー
ターゲット プラットフォーム の ウィンドウズ
ヘッダー msiquery.h
ライブラリ Msi.lib
DLL Msi.dll

関連項目

データベースの とパッチの例

一般的なデータベース アクセス関数の