IAddrBook::SetDefaultDir
适用于:Outlook 2013 | Outlook 2016
将指定的容器建立为默认通讯簿容器。
HRESULT SetDefaultDir(
ULONG cbEntryID,
LPENTRYID lpEntryID
);
参数
cbEntryID
[in] lpEntryID 参数指向的条目标识符中的字节计数。
lpEntryID
[in]指向默认通讯簿容器的入口标识符的指针。
返回值
S_OK
已成功设置默认通讯簿容器。
备注
客户端和服务提供商调用 SetDefaultDir 方法以建立新的默认通讯簿容器。 默认容器是用户首次打开通讯簿时在通讯簿中显示的容器。 SetDefaultDir 将默认容器保存为配置文件中的条目。 容器将保留为默认值,直到在同一会话或另一个会话中对 SetDefaultDir 进行另一次调用,或者删除该容器。
注意
PR_AB_CHOOSE_DIRECTORY_AUTOMATICALLY 属性对应于“通讯簿选项”对话框中的“自动选择”设置。 当此属性存在于 IID_CAPONE_PROF 配置文件部分中并且设置为 true 时,“通讯簿”对话框不再默认为 SetDefaultDir 指定的容器,而是选择 Microsoft Outlook 认为适用于显示对话框的上下文的通讯簿。 请注意,这可能会导致第三方通讯簿提供商体验不佳。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
Abcontdlg.cpp |
CAbContDlg::OnSetDefaultDir |
MFCMAPI 使用 SetDefaultDir 方法将指定的通讯簿容器设置为默认通讯簿容器。 |