共用方式為


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 結構。

另請參閱

MAPIAllocateBuffer

MAPIFreeBuffer

SPropValue

SRow

ITableData:IUnknown