ITableData::HrEnumRow
適用対象: Outlook 2013 | Outlook 2016
テーブル内の位置に基づいて行を取得します。
HRESULT HrEnumRow(
ULONG ulRowNumber,
LPSRow FAR * lppSRow
);
パラメーター
ulRowNumber
[in]プロパティを返す行の番号。 ulRowNumber パラメーターの値には、テーブルの最初の行を示す 0 から n から 1 までの任意の値を指定できます。これは、テーブル内の最後の行を示します。
lppSRow
[out]ターゲット行を記述する SRow 構造体へのポインターへのポインター。
戻り値
S_OK
行が正常に取得されたか、 ulRowNumber パラメーターで指定された行番号の行が存在しません。
注釈
ITableData::HrEnumRow メソッドは、シーケンシャルな数値に基づいて行を取得します。 この数値は挿入順序を表します (0 は最初の行を示し、行数から 1 を引いた行数は最後の行を示します)。 MAPI は、テーブル データ オブジェクトの有効期間中、行挿入のこの時系列の順序を維持します。
ulRowNumber で指定された数値がテーブル内の行に対応していない場合、HrEnumRow はS_OKを返し、lppSRow パラメーターを NULL に設定します。
MAPI は、テーブル データ オブジェクトの作成時に MAPIAllocateBuffer 関数を使用して、返された SRow 構造体のメモリを割り当てます。 呼び出し元は 、MAPIFreeBuffer 関数を呼び出して、このメモリを解放する必要があります。
挿入された順序でテーブルから行を取得するには、テーブル データ オブジェクトユーザーは HrEnumRow メソッドを呼び出します。