MsiViewModify 関数 (msiquery.h)

MsiViewModify 関数は、フェッチされたレコードを更新します。

構文

UINT MsiViewModify(
  [in] MSIHANDLE hView,
  [in] MSIMODIFY eModifyMode,
  [in] MSIHANDLE hRecord
);

パラメーター

[in] hView

ビューへのハンドル。

[in] eModifyMode

変更モードを指定します。 このパラメーターには、次の値のいずれかを指定できます。

[in] hRecord

変更するレコードを処理します。

戻り値

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

メモリ不足の状況では、この関数によってSTATUS_NO_MEMORY例外が発生する可能性があることに注意してください。

注釈

MsiViewModify 関数のMSIMODIFY_VALIDATE、MSIMODIFY_VALIDATE_NEW、MSIMODIFY_VALIDATE_FIELD、MSIMODIFY_VALIDATE_DELETEの値は、実際の更新を実行しません。レコード内のデータが有効であることを確認します。 これらの検証列挙を使用するには、データベースに _Validation テーブルが含まれている必要があります。

挿入または要求されたレコードの 0 番目のフィールドを変更していない場合は、MSIMODIFY_INSERT、MSIMODIFY_INSERT_TEMPORARY、またはMSIMODIFY_SEEKを使用した直後に、レコードでMSIMODIFY_UPDATEまたはMSIMODIFY_DELETEを呼び出すことができます。

SQL ステートメントを実行するには、ビューを作成する必要があります。 ただし、CREATE TABLE や INSERT INTO などの結果セットを作成しないビューを MsiViewModify と共に使用して、ビューを通じてテーブルを更新することはできません。

あるデータベースからバイナリ データを含むレコードをフェッチしてから、そのレコードを使用して別のデータベースにデータを挿入することはできません。 バイナリ データをあるデータベースから別のデータベースに移動するには、データをファイルにエクスポートし、クエリと MsiRecordSetStream を使用して新しいデータベースにインポートする必要があります。 これにより、各データベースがバイナリ データの独自のコピーを持つようになります。

カスタム アクションでは、データベースの一時行、列、またはテーブルのみを追加、変更、または削除できることに注意してください。 カスタム アクションでは、データベース内の永続的なデータを変更することはできません (例えば、ディスクに保存されているデータベースの一部であるデータなど)。 詳細については、「カスタム アクション内から現在のインストーラー セッションにアクセスする」を参照してください。

関数が失敗した場合は、 MsiGetLastErrorRecord を使用して拡張エラー情報を取得できます。

要件

こちらもご覧ください

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