ITableData::HrQueryRow

适用于:Outlook 2013 | Outlook 2016

检索表行。

HRESULT HrQueryRow(
  LPSPropValue lpSPropValue,
  LPSRow FAR * lppSRow,
  ULONG FAR * lpuliRow
);

参数

lpSPropValue

[in]指向属性值结构的指针,该结构描述要检索的行的索引列。 属性值结构的 ulPropTag 成员应包含与调用 CreateTable 函数(访问 ITableData 实现)中的 ulPropTagIndexColumn 参数相同的属性标记。

lppSRow

[out]指向检索到行的指针的指针。

lpuliRow

[in,out]输入时为有效的指针或 NULL,指示无需返回任何信息。 输出时是指向行号的有效指针,该行号是标识行在表中的位置的序号。

返回值

S_OK

已成功检索行。

MAPI_E_INVALID_PARAMETER

lpSPropValue 指向的 SPropValue 结构不包含 index 列属性。

备注

ITableData::HrQueryRow 方法检索具有索引列的行的所有属性,该索引列与 lpSPropValue 指向的属性结构中包含的索引列的值匹配。 如果调用方请求,HrQueryRow 还会返回行号,用于标识行在表中的位置。

由于 HrQueryRow 不会修改 lpSPropValue 指向的 SPropValue 结构,因此调用方必须在 HrQueryRow 返回时释放该结构。 调用方还必须释放包含检索到的行的 SRow 结构。

另请参阅

MAPIAllocateBuffer

MAPIFreeBuffer

SPropValue

SRow

ITableData : IUnknown