SRowSet
適用対象: Outlook 2013 | Outlook 2016
SRow 構造体の配列を格納します。 各 SRow 構造体は、テーブルの行を記述します。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapidefs.h |
| 関連するマクロ: |
CbNewSRowSet、 CbSRowSet、 SizeSRowSet |
typedef struct _SRowSet
{
ULONG cRows;
SRow aRow[MAPI_DIM];
} SRowSet, FAR *LPSRowSet;
メンバー
カラス
aRow メンバー内の SRow 構造体の数。
aRow
SRow 構造体の配列。 テーブル内の各行には 1 つの構造があります。
注釈
SRowSet 構造体は、テーブルから複数行のデータを記述するために使用されます。 SRowSet 構造体は、次の関数に加えて、 IAddrBook、 ITableData、 および IMAPITable インターフェイス メソッドで使用されます。
SRowSet 構造体は 、ADRLIST 構造体と同じように定義され、受信者テーブルの行とアドレス一覧内のエントリを同じように処理できます。 SRowSet 構造体と ADRLIST 構造体の両方を、IMessage::ModifyRecipients やIAddrBook::Address などのメソッドに渡すことができます。
また、 SRowSet 構造体のメモリ割り当ての規則は 、ADRLIST 構造体の場合と同じです。 要約すると、行セット内の各行の lpProps メンバーが指す配列内の各 SPropValue 構造体は、MAPIAllocateBuffer を使用して個別に割り当てる必要があります。 各プロパティ値構造体は、割り当てられた SPropValue 構造体へのポインターが失われないように、その SRowSet 構造体の割り当てを解除する前に MAPIFreeBuffer を使用して割り当てを解除する必要もあります。 その後、行に割り当てられたメモリを保持し、 SRowSet 構造体のコンテキストの外部で再利用できます。
SRowSet 構造体のメモリの割り当て方法の詳細については、「ADRLIST 構造体と SRowSet 構造体のメモリ管理」を参照してください。