IAddrBook::DetailsIAddrBook::Details

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

特定のアドレス帳エントリの詳細を表示するダイアログボックスを表示します。Displays a dialog box that shows details about a particular address book entry.

HRESULT Details(
  ULONG_PTR FAR * lpulUIParam,
  LPFNDISMISS lpfnDismiss,
  LPVOID lpvDismissContext,
  ULONG cbEntryID,
  LPENTRYID lpEntryID,
  LPFNBUTTON lpfButtonCallback,
  LPVOID lpvButtonContext,
  LPSTR lpszButtonText,
  ULONG ulFlags
);

パラメーターParameters

l出 uiparamlpulUIParam

順番ダイアログボックスの親ウィンドウのハンドルへのポインター。[in] A pointer to a handle of the parent window for the dialog box.

lpfnDismisslpfnDismiss

順番DISMISSMODELESSプロトタイプに基づく関数へのポインター、または NULL。[in] A pointer to a function based on the DISMISSMODELESS prototype, or NULL. このメンバーは、DIALOG_SDI フラグが設定されている場合のように、ダイアログボックスのモードレスバージョンにのみ適用されます。This member applies only to the modeless version of the dialog box, as indicated by the DIALOG_SDI flag being set. MAPI は、ユーザーがモードレスアドレスダイアログボックスを閉じたときに、そのダイアログボックスがアクティブでなくなったことを示す詳細を呼び出していることをクライアントに通知するDISMISSMODELESS関数を呼び出します。MAPI calls the DISMISSMODELESS function when the user dismisses the modeless address dialog box, informing a client that is calling Details that the dialog box is no longer active.

lpvDismissContextlpvDismissContext

順番_lpfnDismiss_パラメーターが指すDISMISSMODELESS関数に渡すコンテキスト情報へのポインター。[in] A pointer to context information to pass to the DISMISSMODELESS function pointed to by the lpfnDismiss parameter. このパラメーターは、DIALOG_SDI フラグを_ulflags_パラメーターに含めることによって、ダイアログボックスのモードレスバージョンにのみ適用されます。This parameter applies only to the modeless version of the dialog box, by including the DIALOG_SDI flag in the ulFlags parameter.

cbEntryIDcbEntryID

順番_lな tryid_パラメーターで指定されたエントリ識別子のバイト数。[in] The byte count in the entry identifier pointed to by the lpEntryID parameter.

lて tryidlpEntryID

順番詳細が表示されるエントリのエントリ識別子へのポインター。[in] A pointer to the entry identifier for the entry for which details are displayed.

lpfbuttoncallbacklpfButtonCallback

順番LPFNBUTTON関数プロトタイプに基づく関数へのポインター。[in] A pointer to a function based on the LPFNBUTTON function prototype. LPFNBUTTON関数は、[詳細] ダイアログボックスにボタンを追加します。An LPFNBUTTON function adds a button to the details dialog box.

lpvbuttoncontextlpvButtonContext

順番_lpfbuttoncallback_パラメーターで指定された関数のパラメーターとして使用されたデータへのポインター。[in] A pointer to data that was used as a parameter for the function specified by the lpfButtonCallback parameter.

lpszbuttontextlpszButtonText

順番追加されたボタンに適用されるテキストを含む文字列へのポインター。ボタンが拡張可能な場合です。[in] A pointer to a string that contains text to be applied to the added button, if that button is extensible. 拡張ボタンが必要ない場合は、 _lpszbuttontext_パラメーターを NULL に設定する必要があります。The lpszButtonText parameter should be NULL if you do not need an extensible button.

ulFlagsulFlags

順番_lpszbuttontext_パラメーターのテキストの種類を制御するフラグのビットマスク。[in] A bitmask of flags that controls the type of the text for the lpszButtonText parameter. 次のフラグを設定できます。The following flags can be set:

AB_TELL_DETAILS_CHANGEAB_TELL_DETAILS_CHANGE

アドレスに変更が実際に加えられた場合に、詳細が S_OK を返すことを示します。それ以外の場合、詳細は S_FALSE を返します。Indicates that Details returns S_OK if changes are actually made to the address; otherwise, Details returns S_FALSE.

DIALOG_MODALDIALOG_MODAL

[共通アドレス] ダイアログボックスのモーダルバージョンを表示します。これは、常に非 Outlook クライアントに表示されます。Display the modal version of the common address dialog box, which is always shown in non-Outlook clients. このフラグは、DIALOG_SDI とは相互に排他的です。This flag is mutually exclusive with DIALOG_SDI.

DIALOG_SDIDIALOG_SDI

[共通アドレス] ダイアログボックスのモードレスバージョンを表示します。Display the modeless version of the common address dialog box. このフラグは、Outlook 以外のクライアントでは無視されます。This flag is ignored for non-Outlook clients.

MAPI_UNICODEMAPI_UNICODE

渡された文字列は Unicode 形式です。The passed-in strings are in Unicode format. MAPI_UNICODE フラグが設定されていない場合、文字列は ANSI 形式になります。If the MAPI_UNICODE flag is not set, the strings are in ANSI format.

戻り値Return value

S_OKS_OK

アドレス帳エントリに対して [詳細] ダイアログボックスが正常に表示されました。The details dialog box was successfully displayed for the address book entry.

注釈Remarks

クライアントアプリケーションはDetailsメソッドを呼び出して、アドレス帳の特定のエントリに関する詳細情報を提供するダイアログボックスを表示します。Client applications call the Details method to display a dialog box that provides details about a particular entry in the address book. lpfbuttoncallbacklpfbuttoncallback、および_lpszbuttontext_パラメーターを使用して、クライアント定義ボタンをダイアログボックスに追加できます。You can use the lpfButtonCallback, lpvButtonContext, and lpszButtonText parameters to add a client-defined button to the dialog box. ボタンがクリックされると、MAPI は_lpfbuttoncallback_が指すコールバック関数を呼び出し、ボタンのエントリ識別子と_lpfbuttoncallback_のデータの両方を渡します。When the button is clicked, MAPI calls the callback function pointed to by lpfButtonCallback, passing both the entry identifier of the button and the data in lpvButtonContext. 拡張ボタンが必要ない場合は、 _lpszbuttontext_を NULL にする必要があります。If you do not need an extensible button, lpszButtonText should be NULL.

詳細は、Unicode 文字列をサポートしています。Unicode 文字列は、マルチバイト文字文字列 (MBCS) 形式に変換されてから、[詳細] ダイアログボックスに表示されます。Details supports Unicode character strings; Unicode strings are converted to the multibyte character string (MBCS) format before they are displayed in the details dialog box.

MFCMAPI リファレンスMFCMAPI reference

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

ファイルFile 関数Function コメントComment
basedialogBaseDialog.cpp
cbasedialog:: onopenentryidCBaseDialog::OnOpenEntryID
mfcmapi は、 detailsメソッドを使用して、アドレス帳エントリの詳細を表示するダイアログボックスを表示します。MFCMAPI uses the Details method to display a dialog box that shows the details for an address book entry.

関連項目See also

ADRPARMADRPARM

IAddrBook::AddressIAddrBook::Address

LPFNBUTTONLPFNBUTTON

IAddrBook : IMAPIPropIAddrBook : IMAPIProp

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