ADRENTRYADRENTRY

適用されます: OutlookApplies to: Outlook

受信者に所属する 0 個以上のプロパティについて説明します。Describes zero or more properties that belong to a recipient.

ヘッダー ファイル:Header file:
Mapidefs.hMapidefs.h
typedef struct _ADRENTRY
{
  ULONG ulReserved1;
  ULONG cValues;
  LPSPropValue rgPropVals;
} ADRENTRY, FAR *LPADRENTRY;

メンバーMembers

ulReserved1ulReserved1

予約されています。0 にする必要があります。Reserved; must be zero.

あうcValues

RgPropValsメンバーが指すプロパティの値の配列内のプロパティの数です。Count of properties in the property value array pointed to by the rgPropVals member. あうメンバーは、0 にすることができます。The cValues member can be zero.

rgPropValsrgPropVals

受信者のプロパティを記述するプロパティ値の配列へのポインター。Pointer to a property value array describing the properties for the recipient. RgPropValsのメンバーには、NULL を指定できます。The rgPropVals member can be NULL.

備考Remarks

ADRENTRY構造体では、1 人の受信者のプロパティについて説明します。An ADRENTRY structure describes properties that belong to a single recipient. 受信者の記述に使用される一般的なプロパティを以下に示します。The properties that are typically used to describe a recipient include the following:

PR_DISPLAY_NAME(PidTagDisplayName)PR_DISPLAY_NAME (PidTagDisplayName)

PR_ADDRTYPE(PidTagAddressType)PR_ADDRTYPE (PidTagAddressType)

PR_EMAIL_ADDRESS(PidTagEmailAddress)PR_EMAIL_ADDRESS (PidTagEmailAddress)

PR_ENTRYID(PidTagEntryId)PR_ENTRYID (PidTagEntryId)

エントリの識別子またはPR_ENTRYIDプロパティが表示されたらSPropValue配列の受信者に、受信者が解決されたことを示します。When an entry identifier or PR_ENTRYID property appears in the SPropValue array for a recipient, this indicates that the recipient has been resolved. クライアントは、送信メッセージの受信者の一覧のすべての受信者が解決されたことを確認するのにはIAddrBook::ResolveNameメソッドを呼び出します。Clients call the IAddrBook::ResolveName method to make sure that all recipients in the recipient list of an outgoing message have been resolved. 解決受信者のみにメッセージを送信できます。Only resolved recipients can be sent with messages.

ADRENTRY構造体は通常、 aEntriesADRLIST構造体のメンバーの配列を作成する結合します。ADRENTRY structures are typically combined to form an array for the aEntries member of an ADRLIST structure.

ADRENTRY構造体およびSRowの構造体は、両方を含むので、予約済みのメンバー プロパティの値の配列、配列内の値の数と同じです。ADRENTRY structures and SRow structures are identical because they both contain a reserved member, an array of property values, and a count of values in the array. ADRENTRY構造体は、 aEntriesADRLIST構造体のメンバーをフォームに組み合わせることで、一方、 SRow構造体は、 aRowSRowSet構造体のメンバーをフォームに結合されます。Whereas ADRENTRY structures are combined to form the aEntries member of an ADRLIST structure, SRow structures are combined to form the aRow member of an SRowSet structure. 構造体の両方の種類は、アドレス帳コンテナーのコンテンツ テーブルから取得したSRowSet構造体のADRLIST構造体へのキャストし、は、使用することを示す、同じ割り当て規則に従います。Both types of structures follow the same allocation rules, implying that an SRowSet structure that is retrieved from the contents table of an address book container can be cast to an ADRLIST structure and used as is.

ADRENTRY構造体を空にすることができます。An ADRENTRY structure can be empty. たとえば、 IAddrBook::Addressへの呼び出し内の_lppAdrList_パラメーターで指定されたADRLIST構造体に含まれるADRENTRY構造体は、受信者が削除されるときに空。For example, an ADRENTRY structure that is contained in the ADRLIST structure pointed to by the lppAdrList parameter in a call to IAddrBook::Address can be empty when a recipient is being removed.

ADRENTRY構造体にメモリを割り当てる方法の詳細については、 ADRLIST および SRowSet 構造体のメモリを管理するを参照してください。For more information about how to allocate memory for ADRENTRY structures, see Managing Memory for ADRLIST and SRowSet Structures.

関連項目See also

IAddrBook::AddressIAddrBook::Address

IMessage::ModifyRecipientsIMessage::ModifyRecipients

MAPIAllocateBufferMAPIAllocateBuffer

ADRLISTADRLIST

SRowSRow

SRowSetSRowSet

MAPI の構造MAPI Structures