IMAPISupport::Address

[アーティクル]
04/04/2023

適用対象: Outlook 2013 | Outlook 2016

共通アドレスダイアログボックスを表示します。

HRESULT Address(
  ULONG_PTR FAR * lpulUIParam,
  LPADRPARM lpAdrParms,
  LPADRLIST FAR * lppAdrList
);

パラメーター

lpulUIParam

[in, out]ダイアログボックスの親ウィンドウのハンドルへのポインター。入力時には、ウィンドウハンドルを常に渡す必要があります。出力時に、lpAdrParms パラメーターが指す ADRPARM 構造体で DIALOG_SDI フラグが設定されている場合、モードレスダイアログボックスのウィンドウハンドルが返されます。

lpAdrParms

[in, out]アドレスダイアログボックスの表示と動作を制御する ADRPARM 構造体へのポインター。

lppAdrList

[in, out]アドレス一覧へのポインターへのポインター。入力時に、このリストはメッセージ内の受信者の現在のリストか、そのようなリストが存在しない場合は NULL です。出力時に、 lppAdrList は メッセージ受信者の更新されたリストを指します。

戻り値

S_OK

[アドレス] ダイアログボックスが正常に表示されました。

注釈

IMAPISupport::Address メソッドは、アドレス帳プロバイダーサポートオブジェクトに実装されます。アドレス帳プロバイダーは Address を呼び出して、メッセージ受信者の一覧を作成または更新します。

各受信者は、lppAdrList パラメーターによって指される ADRLIST 構造体に含まれる ADRENTRY 構造体で記述されます。 ADRENTRY 構造体には、受信者のプロパティ値の配列が含まれています。そのうちの 1 つは受信者の型か、PR_RECIPIENT_TYPE (PidTagRecipientType) プロパティです。この ADRLIST 構造体をクライアントに渡して、IMessage::ModifyRecipients の呼び出しで lpMods パラメーターとして使用できます。

ADRLIST 構造体の各受信者は解決できます。これは、そのプロパティ値の 1 つが PR_ENTRYID (PidTagEntryId) プロパティであることを示すか、未解決であり、PR_ENTRYID プロパティが見つからないことを示します。

解決された受信者には、 PR_ENTRYIDに加えて、次のプロパティが含まれます。

PR_RECIPIENT_TYPE
PR_DISPLAY_NAME (PidTagDisplayName)
PR_ADDRTYPE (PidTagAddressType)
PR_DISPLAY_TYPE (PidTagDisplayType)

未解決の受信者には、通常、 PR_DISPLAY_NAMEとPR_RECIPIENT_TYPE のみが含 まれます。

呼び出し側への注意

呼び出し元が渡す ADRLIST 構造体は、MAPI が返す構造体とは異なるサイズである可能性があります。 ADRLIST 構造体にメモリを割り当てる場合は、SPropValue 構造体ごとに個別にメモリを割り当てます。

ABProviderInit 関数に渡される MAPI メモリ割り当て関数へのポインターを使用して、メモリを割り当てます。 ADRLIST の MAPIAllocateBuffer 関数と 、ADRLIST の ADRENTRY 構造体の各プロパティ値 構造体を使用してメモリを割り当てます。

Address がより大きな ADRLIST 構造体を返す必要がある場合、または lppAdrList に NULL を渡した場合、Address は元の構造体を解放し、新しい構造体を割り当てます。 また、アドレス は ADRLIST 構造体に追加のプロパティ値構造体を割り当て、必要に応じて古いプロパティ値を解放します。 ADRLIST 構造体のメモリ管理方法の詳細については、「 ADRLIST構造体と SRowSet 構造体のメモリの管理」を参照してください。

lpAdrParms パラメーターの ADRPARM 構造体でDIALOG_SDI フラグが設定されている場合、アドレスは直ちにを返します。

IMAPISupport::Address

パラメーター

戻り値

注釈

呼び出し側への注意

関連項目

その他のリソース