CRowset::UpdateAll

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

最後のフェッチまたは Update 呼び出し以降に行われたすべての行に対する保留状態の変更を送信します。

HRESULT UpdateAll( 
   DBCOUNTITEM* pcRows = NULL, 
   HROW** pphRow = NULL, 
   DBROWSTATUS** ppStatus = NULL  
) throw( );

パラメータ

pcRows
[出力] 必要に応じて UpdateAll が更新しようとした行数を返す場所を指すポインタ。
pphRow
[出力] UpdateAll が更新しようとした行のハンドルを返すメモリを指すポインタ。pphRow に NULL を指定すると、ハンドルは返されません。
ppStatus
[出力] Update メソッドが行のステータスの値を返す場所を指すポインタ。ppStatus に NULL を指定すると、ステータスは返されません。

解説

Update または UpdateAll を使用して、その行が最後にフェッチまたは更新されてからすべての行に加えられた保留状態の変更を送信します。UpdateAll は、ハンドルを保持しているかどうかにかかわらず (pphRow を参照)、変更されたすべての行を更新します。

たとえば、Insert を使用して行セットに 5 行を挿入した場合は、Update を 5 回呼び出すか、UpdateAll を 1 回呼び出して、すべての行を更新できます。

このメソッドでは、省略可能なインターフェイス IRowsetUpdate が必要です。これはすべてのプロバイダでサポートされているとは限りません。サポートされていない場合、このメソッドは E_NOINTERFACE を返します。また、行セットを含むテーブルまたはコマンドで Open を呼び出す前に、DBPROP_IRowsetUpdate を VARIANT_TRUE に設定する必要があります。