IAddrBook::AddressIAddrBook::Address

適用対象: Outlook 2013 | Outlook 2016Applies to: Outlook 2013 | Outlook 2016

[Outlook アドレス帳] ダイアログボックスを表示します。Displays the Outlook address book dialog box.

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

パラメーターParameters

l出 uiparamlpulUIParam

[入力]ダイアログボックスの親ウィンドウのハンドルへのポインター。[in, out] A pointer to a handle of the parent window of the dialog box. 入力時には、ウィンドウハンドルを常に渡す必要があります。On input, a window handle must always be passed. 出力では、 _lpadrparms_パラメーターのulflagsメンバーが DIALOG_SDI に設定されている場合、モードレスダイアログボックスのウィンドウハンドルが返されます。On output, if the ulFlags member of the lpAdrParms parameter is set to DIALOG_SDI, the window handle of the modeless dialog box is returned. 注釈を参照してください。See Remarks.

lpadrparmslpAdrParms

[入力][アドレス] ダイアログボックスの表示と動作を制御するADRPARM構造体へのポインター。[in, out] A pointer to an ADRPARM structure that controls the presentation and behavior of the address dialog box.

lppadrlistlppAdrList

[入力]受信者の情報を含むadrlist構造体へのポインターへのポインター。[in, out] A pointer to a pointer to an ADRLIST structure that contains recipient information. 入力時には、このパラメーターを NULL にしたり、有効なポインターをポイントしたりすることができます。On input, this parameter can be NULL or point to a valid pointer. 出力では、このパラメーターは有効な受信者情報へのポインターを指します。On output, this parameter points to a pointer to valid recipient information.

戻り値Return value

S_OKS_OK

[共通アドレス] ダイアログボックスが正常に表示されました。The common address dialog box was successfully displayed.

注釈Remarks

_lpadrparms_パラメーターのulflagsメンバーが DIALOG_SDI に設定されている場合、出力時にモードレスダイアログボックスのウィンドウハンドルの戻り値を予測します。これは Outlook では無視されます。ダイアログのモーダルバージョンは常に、Outlook 以外のクライアントに表示されます。If the ulFlags member of the lpAdrParms parameter is set to DIALOG_SDI anticipating the return of the window handle of the modeless dialog box on output, it is ignored in Outlook; the modal version of the dialog is always shown in non-Outlook clients.

_lppadrlist_パラメーターを使用して、MAPI によって発信者に渡されたadrlist構造体には、各受信者に対応する1つのadrlist構造の配列が含まれています。The ADRLIST structure passed back by MAPI to the caller through the lppAdrList parameter contains an array of ADRENTRY structures, one structure for each recipient. _lpMods_パラメーターの送信メッセージのIMessage:: modifyrecipientsメソッドに渡されると、 adrlist構造を使用して、その受信者リストを更新できます。When passed to an outgoing message's IMessage::ModifyRecipients method in the lpMods parameter, the ADRLIST structure can be used to update its recipient list.

adrentry構造体内の各adrentry構造には、0個以上のspropvalue構造体、および受信者のすべてのプロパティセットに対する1つの構造が含まれています。Each ADRENTRY structure in the ADRLIST structure contains zero or more SPropValue structures, one structure for every property set for the recipient. Addressメソッドによって提供されるダイアログボックスを使用して受信者を削除する場合は、ゼロのspropvalue構造が可能です。There can be zero SPropValue structures when the dialog box presented by the Address method is used to remove a recipient. 1つ以上のspropvalue構造体がある場合は、対応するadrentry構造を使用して、受信者を追加または更新します。When there are one or more SPropValue structures, the corresponding ADRENTRY structure is used to add or update a recipient. 受信者を解決できます。これは、 spropvalue構造の1つが、受信者のPR_ENTRYID (PidTagEntryId) プロパティ、または未解決であることを示しています。これは、 PR_ENTRYIDプロパティがれ.The recipient can be resolved, which indicates that one of the SPropValue structures describes the recipient's PR_ENTRYID (PidTagEntryId) property, or unresolved, which indicates that the PR_ENTRYID property is missing.

PR_ENTRYIDに加えて、解決された受信者には次のプロパティが含まれています。In addition to PR_ENTRYID, resolved recipients include the following properties:

発信者が渡すadrlist構造は、MAPI が返す構造体のサイズと異なる場合があります。The ADRLIST structure that the caller passes in might be a different size from the structure that MAPI returns. MAPI がより大きなadrlist構造を返す必要がある場合は、元の構造を解放して新しい構造を割り当てます。If MAPI must return a larger ADRLIST structure, it frees the original structure and allocates a new one. adrlist構造体のメモリを割り当てるときは、各spropvalue構造体のメモリを個別に割り当てます。When you allocate memory for the ADRLIST structure, allocate the memory for each SPropValue structure separately. adrlist構造体の割り当ておよび解放方法の詳細については、「 adrlist および srowset 構造体のメモリの管理」を参照してください。For more information about how to allocate and free ADRLIST structures, see Managing Memory for ADRLIST and SRowSet Structures

DIALOG_SDI フラグが_lpadrparms_パラメーターのADRPARM構造のulflagsメンバーで設定されている場合は、すぐにアドレスが返されます。Address returns immediately if the DIALOG_SDI flag is set in the ulFlags member of the ADRPARM structure in the lpAdrParms parameter. Outlook 以外のクライアントでは、DIALOG_SDI フラグは無視されます。The DIALOG_SDI flag is ignored for non-Outlook clients. DIALOG_SDI が無視される場合は、ダイアログのモーダルバージョンが表示され、ハンドルへのポインターは_lアウト uiparam_では想定されません。If DIALOG_SDI is ignored, the modal version of the dialog will be displayed and a pointer to a handle should not be expected in lpulUIParam.

AddressADRPARM構造で unicode 文字列をサポートしています。 _lpadrparms_パラメーターのADRPARMulflagsメンバーで AB_UNICODEUI が指定されており、それが unicode文字列をサポートしている場合adrlistAddress supports Unicode character strings in the ADRPARM structure if AB_UNICODEUI was specified in the ulFlags member of ADRPARM in the lpAdrParms parameter, and it supports Unicode character strings in ADRLIST. Unicode 文字列は、Outlook の [アドレス帳] ダイアログボックスに表示される前に、マルチバイト文字文字列 (MBCS) 形式に変換されます。The Unicode strings are converted to the multibyte character string (MBCS) format before they are displayed in the Outlook address book dialog box.

MFCMAPI リファレンスMFCMAPI reference

MFCMAPI のサンプル コードについては、次の表を参照してください。For MFCMAPI sample code, see the following table.

ファイルFile 関数Function コメントComment
MAPIStoreFunctionsMAPIStoreFunctions.cpp
OpenOtherUsersMailboxFromGalOpenOtherUsersMailboxFromGal
mfcmapi は、 Addressメソッドを使用して、開くメールボックスをユーザーが選択できるようにします。MFCMAPI uses the Address method to allow the user to select which mailbox to open.

関連項目See also

ADRENTRYADRENTRY

ADRLISTADRLIST

ADRPARMADRPARM

FreePadrlistFreePadrlist

FreeProwsFreeProws

IMAPITable::QueryRowsIMAPITable::QueryRows

IMessage::ModifyRecipientsIMessage::ModifyRecipients

MAPIAllocateBufferMAPIAllocateBuffer

MAPIAllocateMoreMAPIAllocateMore

MAPIFreeBufferMAPIFreeBuffer

SPropValueSPropValue

SRowSetSRowSet

IAddrBook : IMAPIPropIAddrBook : IMAPIProp

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample

[�R��h �T���v���Ƃ��� MFCMAPIMFCMAPI as a Code Sample