请勿使用。 由 Windows 通讯簿 (WAB) 用于初始化用户的 IContextMenu 接口 和 IShellPropSheetExt 接口 实现。
语法
typedef struct _WABEXTDISPLAY {
ULONG cbSize;
LPWABOBJECT lpWABObject;
LPADRBOOK lpAdrBook;
LPMAPIPROP lpPropObj;
BOOL fReadOnly;
BOOL fDataChanged;
ULONG ulFlags;
LPVOID lpv;
LPTSTR lpsz;
} WABEXTDISPLAY, *LPWABEXTDISPLAY;
成员
cbSize
类型: ULONG
未使用。
lpWABObject
类型: LPWABOBJECT
指向 IWABObject 接口的指针,该接口指定要用于调用 IWABObject 内存分配方法的对象。 这些方法分配你传回 WAB 并且你希望 WAB 释放或使用的任何内存。 还可以使用此指针调用任何其他 IWABObject 方法。
lpAdrBook
类型: LPADRBOOK
指向 IAddrBook 接口的指针,该接口指定要用于调用任何标准 WAB IAddrBook 方法的对象。
lpPropObj
类型: LPMAPIPROP
指向 IMailUser 的指针:IMAPIProp 对象。 此接口与 IShellPropSheetExt 接口 和 IContextMenu 接口 实现相关。 对于 IShellPropSheetExt 接口实现, lpPropObj 包含要显示的实际对象。 它可以是 IMailUser : IMAPIProp 或 IDistList : IMAPIContainer 对象。 若要确定哪个对象 lpPropObj ,请查询其PR_OBJECT_TYPE属性。 可以从此对象检索属性以填充扩展属性表。
对于 IContextMenu 接口 实现, lpPropObj 包含有效的 对象;但是,此对象没有任何与之关联的属性。 可以对此对象调用 AddRef ,以确保此 WABEXTDISPLAY 结构中感兴趣的对象和任何其他数据只要需要它即可生存。 如果调用 AddRef,则必须在不再需要时在 lpPropObj 上调用 Release。
如果应用程序使用命名属性,并且你想要从 WAB 获取与你相关的命名属性,则可以在此 lpPropObj 对象上调用 GetIDsfromNames 方法来检索任何此类命名属性。 如果要访问与消息用户关联的属性,请在调用该对象上的 GetIDsfromNames 之前将此对象强制转换为 LPMAILUSER 。
fReadOnly
类型: BOOL
BOOL 类型的变量,指定某些类型的对象的只读属性,例如VCARD_NAME属性、LDAP 搜索结果和一次性 MailUser。 此成员仅与 IShellPropSheetExt 接口相关。 如果此标志设置为 true,则属性表必须将其所有控件设置为只读或禁用模式,通常是为了响应 WM_INITDIALOG 消息。 将控件设置为只读状态可使用户体验更加一致。
fDataChanged
类型: BOOL
BOOL 类型的变量,指定指示已对属性表进行更改的标志。 此成员仅与 IShellPropSheetExt 接口 相关。 每当用户进行更改(例如在属性表上添加、编辑或删除数据)时,必须将此标志设置为 true,以向 WAB 发出属性表上的数据已更改的信号。 如果未设置此标志,WAB 可能不会保留用户对属性表所做的更改。
ulFlags
类型: ULONG
ULONG 类型的变量,用于指定控制行为的标志。 以下标志有效。
WAB_CONTEXT_ADRLIST
在调用 IContextMenu 接口方法之前,WAB 调用 Initialize 时设置。 此标志指示 lpv 包含指向 ADRLIST 结构的指针。 ADRLIST 结构包含一个或多个条目,每个条目对应于 WAB 用户界面中的选定项。 若要检索并使用此 ADRLIST,请将 lpv 强制转换为 LPADRLIST。 还可以使用 ulFlags 来确定 正在使用 WABEXTDISPLAY 初始化 IContextMenu 接口操作。 如果 ulFlags 不包含此标志,则可以安全地假定结构用于 IShellPropSheetExt 接口 操作。
WAB_DISPLAY_LDAPURL
指示 lpsz 包含当前显示的 LDAP URL。 有时,WAB 会在由 LDAP URL 表示的联系人上显示属性表。 当 LDAP URL 点将包装到 WAB 对象并放置在 lpPropObj 中的联系人时,属性表可以直接访问 URL。
lpv
类型: LPVOID
指定传递给应用程序的杂项信息的指针。 当前标志标识所表示的信息。 如果 ulFlags 设置为 WAB_CONTEXT_ADRLIST, 则 lpv 包含指向 ADRLIST 的指针。 将 lpv 强制转换为 ADRLIST 以访问 ADRLIST 的内容。 lpAdrList-cEntries> 成员包含所选项的数目。 lpAdrList-aEntries> 中的 ADRENTRY 结构包含 SPropValue 数组,其中包含与每个选定项相关的所有属性。
lpsz
类型: LPTSTR
LPTSTR 类型的变量,指定用于将杂项信息传递到应用程序的字符串。 当前标志标识所表示的信息。 如果 ulFlags 设置为 WAB_DISPLAY_LDAPURL, 则 lpsz 成员包含指向 NULL 终止字符串 的指针,该字符串包含要显示其属性的 LDAP URL。
要求
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 标头 | wabapi.h |