IAddrBook::GetDefaultDir
适用于:Outlook 2013 | Outlook 2016
返回初始通讯簿容器的条目标识符。
HRESULT GetDefaultDir(
ULONG FAR * lpcbEntryID,
LPENTRYID FAR * lppEntryID
);
参数
l恩特利ID
[out]指向 lppEntryID 参数指向的条目标识符中的字节计数的指针。
lppEntryID
[out]指向指向默认容器的条目标识符的指针的指针。
返回值
S_OK
已成功返回默认容器的条目标识符。
备注
客户端应用程序和服务提供商调用 GetDefaultDir 方法以检索默认通讯簿容器的入口标识符。 默认容器是用户首次打开通讯簿时在通讯簿中显示的容器。 如果尚未通过调用 IAddrBook::SetDefaultDir 方法设置默认容器,则 MAPI 会将名称不是个人通讯簿的第一个容器分配为默认容器, (PAB) 。 如果找不到此类容器,PAB 将成为默认容器。
若要设置默认目录,客户端或提供程序调用 SetDefaultDir 方法。 客户端和提供程序不必调用 IMAPIProp::SaveChanges 方法;由于对通讯簿的更改不会进行交易,因此更改将立即永久更改。
MFCMAPI 引用
有关 MFCMAPI 示例代码,请参阅下表。
文件 | 函数 | Comment |
---|---|---|
MainDlg.cpp |
CMainDlg::OnOpenDefaultDir |
MFCMAPI 使用 GetDefaultDir 方法获取默认通讯簿容器的 ID。 |