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 方法将指定的通讯簿容器设置为默认通讯簿容器。

另请参阅

IAddrBook::GetDefaultDir

IAddrBook::GetSearchPath

IMAPISession::Logoff

MAPILogonEx

IAddrBook : IMAPIProp

MFCMAPI 代码示例