ITableData::HrDeleteRows
適用於:Outlook 2013 |Outlook 2016
刪除多個數據表數據列。
HRESULT HrDeleteRows(
ULONG ulFlags,
LPSRowSet lprowsetToDelete,
ULONG FAR * cRowsDeleted
);
參數
ulFlags
[in]控制刪除的旗標位掩碼。 您可以設定下列旗標:
TAD_ALL_ROWS
從數據表和所有對應的檢視中刪除所有數據列,並傳送單一TABLE_RELOAD通知。
lprowsetToDelete
[in]數據列集的指標,描述要刪除的數據列。 如果在ulFlags參數中設定TAD_ALL_ROWS旗標,則 lprowsetToDelete 參數可以是 NULL。
cRowsDeleted
[out]已刪除數據列的計數。
傳回值
S_OK
數據表數據列已成功刪除。
註解
ITableData::HrDeleteRows 方法會找出並移除數據表數據列,其中包含的數據行符合數據列集中每個 aRow 專案之 lpProps 成員所指向的屬性。 索引數據行可用來識別每個數據列;此數據行的屬性標記必須與呼叫 CreateTable 函式中 ulPropTagIndexColumn 參數中傳遞的屬性卷標相同。
實際刪除的數據列數目會在 cRowsDeleted 中傳回。 如果找不到一或多個數據列,則不會傳回任何錯誤。
刪除數據列之後,會將通知傳送給具有數據表檢視的所有客戶端或服務提供者,且這些客戶端或服務提供者已呼叫數據表的 IMAPITable::Advise 方法來註冊通知。
刪除數據列並不會減少現有數據表檢視或後續開啟的數據表檢視可用的數據行,即使刪除的數據列是具有特定數據行值的最後一個數據列也一樣。