IAddrBook::Details

项目
04/04/2023

适用于：Outlook 2013 | Outlook 2016

显示一个对话框，该对话框显示有关特定通讯簿条目的详细信息。

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

参数

lpulUIParam

[in]指向对话框的父窗口句柄的指针。

lpfnDismiss

[in]指向基于 DISMISSMODELESS 原型的函数的指针，或 NULL。此成员仅适用于对话框的无模式版本，如设置DIALOG_SDI标志所示。当用户关闭无模式地址对话框时，MAPI 调用 DISMISSMODLESS 函数，通知调用 “详细信息” 的客户端该对话框不再处于活动状态。

lpvDismissContext

[in]指向要传递给 lpfnDismiss 参数指向的 DISMISSMODELESS 函数的上下文信息的指针。此参数仅适用于对话框的无模式版本，方法是在 ulFlags 参数中包含 DIALOG_SDI 标志。

cbEntryID

[in] lpEntryID 参数指向的条目标识符中的字节计数。

lpEntryID

[in]指向显示详细信息的条目的条目标识符的指针。

lpfButtonCallback

[in]指向基于 LPFNBUTTON 函数原型的函数的指针。 LPFNBUTTON 函数将按钮添加到详细信息对话框。

lpvButtonContext

[in]指向用作 lpfButtonCallback 参数指定的函数参数的数据的指针。

lpszButtonText

[in]指向字符串的指针，该字符串包含要应用于已添加按钮的文本（如果该按钮是可扩展的）。如果不需要可扩展按钮， lpszButtonText 参数应为 NULL。

ulFlags

[in]控制 lpszButtonText 参数的文本类型的标志的位掩码。可以设置以下标志：

AB_TELL_DETAILS_CHANGE

指示如果实际对地址进行了更改， 则详细信息 返回S_OK;否则， 详细信息 返回S_FALSE。

DIALOG_MODAL

显示通用地址对话框的模式版本，该对话框始终显示在非 Outlook 客户端中。此标志与DIALOG_SDI互斥。

DIALOG_SDI

显示通用地址对话框的无模式版本。对于非 Outlook 客户端，忽略此标志。

MAPI_UNICODE

传入的字符串采用 Unicode 格式。如果未设置MAPI_UNICODE标志，则字符串采用 ANSI 格式。

返回值

S_OK

已成功显示通讯簿条目的详细信息对话框。

备注

客户端应用程序调用 Details 方法以显示一个对话框，该对话框提供有关通讯簿中特定条目的详细信息。可以使用 lpfButtonCallback、 lpvButtonContext 和 lpszButtonText 参数向对话框添加客户端定义的按钮。单击按钮时，MAPI 会调用 lpfButtonCallback 指向的回调函数，传递按钮的入口标识符和 lpvButtonContext 中的数据。如果不需要可扩展的按钮， lpszButtonText 应为 NULL。

详细信息 支持 Unicode 字符串;Unicode 字符串将转换为多字节字符串 (MBCS) 格式，然后再显示在详细信息对话框中。