ITableData::HrQueryRow
適用於:Outlook 2013 |Outlook 2016
擷取數據表數據列。
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
參數
lpSPropValue
[in]屬性值結構的指標,描述要擷取之數據列的索引數據行。 屬性值結構的 ulPropTag 成員應該包含與 CreateTable 函式呼叫中的 ulPropTagIndexColumn 參數相同的屬性標記,後者會存取 ITableData 實作。
lppSRow
[out]擷取數據列指標的指標。
lpuliRow
[in, out]在輸入時為有效的指標或 NULL,表示不需要傳回任何資訊。 在輸出上,指向數據列數據列編號的有效指標,這是識別數據列在數據表中位置的循序數位。
傳回值
S_OK
已成功擷取數據列。
MAPI_E_INVALID_PARAMETER
lpSPropValue 指向的 SPropValue 結構不包含索引數據行屬性。
註解
ITableData::HrQueryRow 方法會擷取數據列的所有屬性,該數據列具有符合 lpSPropValue 所指向之屬性結構中所包含之索引數據行值的索引數據行。 HrQueryRow 也會傳回數據列編號,如果呼叫端要求,則會識別數據列在數據表中的位置。
因為 HrQueryRow 不會修改 lpSPropValue 所指向的 SPropValue 結構,所以呼叫端必須在 HrQueryRow 傳回時釋放結構。 呼叫端也必須釋放包含所擷取數據列的 SRow 結構。