ADRENTRY

適用対象: Outlook 2013 | Outlook 2016

受信者に属する 0 個以上のプロパティについて説明します。

値	説明
ヘッダー ファイル:	Mapidefs.h

typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

メンバー

ulReserved1

予約;は 0 にする必要があります。

cValues

rgPropVals メンバーが指すプロパティ値配列内のプロパティの数。 cValues メンバーは 0 にすることができます。

rgPropVals

受信者のプロパティを記述するプロパティ値配列へのポインター。 rgPropVals メンバーは NULL にすることができます。

注釈

ADRENTRY 構造体は、1 つの受信者に属するプロパティを記述します。 通常、受信者の説明に使用されるプロパティには、次のものが含まれます。

PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID (PidTagEntryId)

受信者の SPropValue 配列にエントリ識別子またはPR_ENTRYID プロパティが表示されると、受信者が解決されたことを示します。 クライアントは IAddrBook::ResolveName メソッドを呼び出して、送信メッセージの受信者リスト内のすべての受信者が解決されていることを確認します。 解決された受信者のみがメッセージと共に送信できます。

ADRENTRY 構造体は、通常、ADRLIST 構造体の aEntries メンバーの配列を形成するために結合されます。

ADRENTRY 構造体と SRow 構造体は両方とも予約済みメンバー、プロパティ値の配列、および配列内の値の数を含んでいるため、同じです。 ADRENTRY 構造体は ADRLIST 構造体の aEntries メンバーを形成するために結合されますが、SRow 構造体は SRowSet 構造体の aRow メンバーを形成するために結合されます。 どちらの種類の構造体も同じ割り当て規則に従います。つまり、アドレス帳コンテナーのコンテンツ テーブルから取得される SRowSet 構造体を ADRLIST 構造体にキャストし、そのまま使用できることを意味します。

ADRENTRY 構造体は空にすることができます。 たとえば、IAddrBook::Address の呼び出しで lppAdrList パラメーターによって指される ADRLIST 構造体に含まれる ADRENTRY 構造体は、受信者が削除されるときに空になる可能性があります。

ADRENTRY 構造体にメモリを割り当てる方法の詳細については、「ADRLIST および SRowSet 構造体のメモリの管理」を参照してください。

関連項目

IAddrBook::Address
IMessage::ModifyRecipients
MAPIAllocateBuffer
ADRLIST
SRow
SRowSetMAPI 構造体