ITableData::HrModifyRow
適用対象: Outlook 2013 | Outlook 2016
既存の行を置き換える可能性がある、新しいテーブル行を挿入します。
HRESULT HrModifyRow(
LPSRow lpSRow
);
パラメーター
lpSRow
[in]追加する行、または既存の行を置き換える行を記述する SRow 構造体へのポインター。 SRow 構造体の lpProps メンバーが指すプロパティ値構造体の 1 つに、CreateTable 関数の呼び出しで ulPropTagIndexColumn パラメーターで指定されたのと同じ値であるインデックス列が含まれている必要があります。
戻り値
S_OK
行が正常に挿入または変更されました。
MAPI_E_INVALID_PARAMETER
渡された行にインデックス列がありません。
注釈
ITableData::HrModifyRow メソッドは、lpSRow パラメーターによって指される SRow 構造体によって記述された行を挿入します。 インデックス列の値が lpSRow が指す行と同じ値を持つ行がテーブルに既に存在する場合、既存の行が置き換えられます。 SRow 構造体に含まれる行と一致する行が存在しない場合、HrModifyRow はテーブルの末尾に行を追加します。
テーブルのすべてのビューは、 lpSRow が指す行を含むように変更されます。 ただし、ビューに行を除外する制限がある場合は、ユーザーに表示されない可能性があります。
lpSRow が指す行の列は、テーブル内の列と同じ順序である必要はありません。 呼び出し元は、現在テーブルに存在しない列プロパティとして含めることもできます。 既存のビューの場合、 HrModifyRow はこれらの新しい列を使用できますが、現在の列セットには含まれません。 今後のビューの 場合、HrModifyRow には列セットに新しい列が含まれます。
HrModifyRow が行を追加すると、テーブルのビューを持ち、通知を登録するためにテーブルの IMAPITable::Advise メソッドを呼び出したすべてのクライアントまたはサービス プロバイダーに通知が送信されます。