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。

另请参阅

IAddrBook::SetDefaultDir

MAPIAllocateBuffer

MAPIFreeBuffer

PidTagContainerFlags 规范属性

IAddrBook : IMAPIProp

MFCMAPI 代码示例