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 方法來註冊通知。 如果因為限制而未將插入的數據列包含在檢視中，則不會傳送任何通知。