ITableData::HrInsertRow
適用対象: Outlook 2013 | Outlook 2016
テーブル行を挿入します。
HRESULT HrInsertRow(
ULONG uliRow,
LPSRow lpSRow
);
パラメーター
uliRow
[in]特定の行を表すシーケンシャル行番号。 新しい行は、数値が示す行の後に配置されます。 uliRow パラメーターには、0 から n までの行番号を含めることができます。n はテーブル内の行の合計数です。 uliRow で n を渡すと、テーブルの末尾に行が追加されます。
lpSRow
[in]挿入する行を記述する SRow 構造体へのポインター。
戻り値
S_OK
行が正常に挿入されました。
MAPI_E_INVALID_PARAMETER
挿入する行と同じインデックス列の値を持つ行がテーブルに既に存在します。
注釈
ITableData::HrInsertRow メソッドは、特定の位置にあるテーブルに行を挿入します。 新しい行は、 uliRow パラメーターで指定された位置にある行の後に挿入されます。
uliRow がテーブル内の行数に設定されている場合、新しい行がテーブルの末尾に追加されます。
テーブルのインデックス列として機能するプロパティは、lpSRow パラメーターによって指される SRow 構造体の lpProps メンバーに含める必要があります。 このインデックス プロパティ (通常 はPR_INSTANCE_KEY (PidTagInstanceKey) は、将来のメンテナンス タスクの行を一意に識別するために使用されます。
SRow 構造体のプロパティ列は、テーブル内のプロパティ列と同じ順序である必要はありません。
行が挿入されると、テーブルのビューを持ち、テーブルの IMAPITable::Advise メソッドを呼び出して通知を登録するすべてのクライアントまたはサービス プロバイダーに通知が送信されます。 制限のために挿入された行がビューに含まれていない場合、通知は送信されません。