ITableData::HrQueryRow
適用対象: Outlook 2013 | Outlook 2016
テーブル行を取得します。
HRESULT HrQueryRow(
LPSPropValue lpSPropValue,
LPSRow FAR * lppSRow,
ULONG FAR * lpuliRow
);
パラメーター
lpSPropValue
[in]取得する行のインデックス列を記述するプロパティ値構造体へのポインター。 プロパティ値構造体の ulPropTag メンバーには、ITableData 実装にアクセスする CreateTable 関数の呼び出しから ulPropTagIndexColumn パラメーターと同じプロパティ タグを含める必要があります。
lppSRow
[out]取得した行へのポインターへのポインター。
lpuliRow
[in, out]入力時に、情報を返す必要がないことを示す有効なポインターまたは NULL。 出力時に、行の行番号を指す有効なポインター。テーブル内の行の位置を識別するシーケンシャル番号。
戻り値
S_OK
行が正常に取得されました。
MAPI_E_INVALID_PARAMETER
lpSPropValue が指す SPropValue 構造体には、インデックス列プロパティが含まれていません。
注釈
ITableData::HrQueryRow メソッドは、lpSPropValue が指すプロパティ構造に含まれるインデックス列の値と一致するインデックス列を持つ行のすべてのプロパティを取得します。 HrQueryRow は、呼び出し元が要求した場合、テーブル内の行の位置を識別する行番号も返します。
HrQueryRow は lpSPropValue が指す SPropValue 構造体を変更しないため、呼び出し元は HrQueryRow が返されるときに構造体を解放する必要があります。 呼び出し元は、取得した行を含む SRow 構造体も解放する必要があります。