ITableData：：HrModifyRow
適用於：Outlook 2013 |Outlook 2016
插入新的數據表數據列，可能取代現有的數據列。
HRESULT HrModifyRow(
LPSRow lpSRow
);
參數
lpSRow
[in] SRow 結構的指標，描述要加入或取代現有數據列的數據列。 SRow 結構的 lpProps 成員所指向的其中一個屬性值結構應該包含索引數據行，此值與呼叫 CreateTable 函式時在 ulPropTagIndexColumn 參數中指定的值相同。
傳回值
S_OK
數據列已成功插入或修改。
MAPI_E_INVALID_PARAMETER
傳入的數據列沒有索引數據行。
註解
ITableData：：HrModifyRow 方法會插入 lpSRow 參數所指向的 SRow 結構所描述的數據列。 如果數據列的索引數據行值與 lpSRow 所指向的數據列相同，且該數據列已經存在於數據表中，則會取代現有的數據列。 如果不存在符合 SRow 結構中所含數據列的數據列， HrModifyRow 會將數據列新增至數據表結尾。
數據表的所有檢視都會修改為包含 lpSRow 所指向的數據列。 不過，如果檢視有排除數據列的限制，使用者可能看不到它。
lpSRow 所指向之數據列中的數據行不一定與數據表中的數據行順序相同。 呼叫端也可以包含為目前不在數據表中的數據行屬性。 對於現有的檢視， HrModifyRow 可讓這些新的數據行可供使用，但不會將它們包含在目前的數據行集中。 針對未來的檢視， HrModifyRow 會在數據行集中包含新的數據行。
在 HrModifyRow 新增數據列之後，通知會傳送給具有數據表檢視的所有客戶端或服務提供者，且這些客戶端或服務提供者已呼叫數據表的 IMAPITable：：Advise 方法來註冊通知。