C++ 应用程序中的 Outlook MAPI：按姓名查找联系人答案

【问题标题】：Outlook MAPI in C++ application: Find contacts by nameC++ 应用程序中的 Outlook MAPI：按姓名查找联系人
【发布时间】：2019-08-21 10:58:47
【问题描述】：

我有一个 C++ 应用程序来检索 Outlook 联系人：（本地和交换）用户和分发列表）

我通过使用获得了一个接口文件“msoutl.tlh”：

#import "C:\Program Files (x86)\Common Files\microsoft shared\OFFICE15\mso.dll" named_guids

#import "c:\Program Files (x86)\Microsoft Office\Office15\MSOUTL.OLB" no_namespace rename("Folder", "OlkFolder") rename("CopyFile", "OlkCopyFile") rename("GetOrganizer", "GetOrganizerAE")

我可以使用所有 Outlook MAPI 类

这样，我可以从 Outlook 客户端获取所有联系人（删除 NULL 和 HRESULT 检查）：

    _ApplicationPtr pApp;
_NameSpacePtr _nsPtr = pApp->GetNamespace(_bstr_t("MAPI"));
AddressListsPtr lists = _nsPtr->GetAddressLists();
AddressListPtr list;
char s[256];

for (int i = 1; i <= lists->GetCount(); i++)
{
    list = lists->Item(i);
    AddressEntries* pAddrEntries = nullptr;
    AddressEntryPtr addEntryPtr = pAddrEntries->GetFirst();
    while (addEntryPtr)
    {
        _ExchangeUserPtr pExchangeUser = nullptr;
        BSTR bstrPropName = nullptr;
        BSTR bstrPropAddr = nullptr;
        BSTR bstrSMTPAddr = nullptr;
        OlAddressEntryUserType userType;
        AddressEntriesPtr pAaddrEntries = nullptr;

        addEntryPtr->get_Name(&bstrPropName);
        addEntryPtr->get_Address(&bstrPropAddr);
        userType = addEntryPtr->GetAddressEntryUserType();

        switch (userType)
        {
        case olExchangeUserAddressEntry: // 0
        {
            addEntryPtr->raw_GetExchangeUser(&pExchangeUser);
            pExchangeUser->get_PrimarySmtpAddress(&bstrSMTPAddr);
            sprintf(s, "EXCHANGE USER: %S (%S) \n", (WCHAR*)bstrPropName, (WCHAR*)bstrSMTPAddr);
            break;
        }
        case olExchangeDistributionListAddressEntry: // 1
        {
            if (S_OK == addEntryPtr->get_Members(&pAaddrEntries))
            {
                _ExchangeDistributionListPtr exchangeDistrList = nullptr;
                addEntryPtr->raw_GetExchangeDistributionList(&exchangeDistrList);
                exchangeDistrList->get_PrimarySmtpAddress(&bstrSMTPAddr);
                sprintf(s, "EXCHANGE DISTRIBUTION LIST: %S (%S) - %d members \n", (WCHAR*)bstrPropName, (WCHAR*)bstrSMTPAddr, pAaddrEntries->GetCount());
            }
            break;
        }

        case olOutlookContactAddressEntry: // 10
        {
            sprintf(s, "OUTLOOK CONTACT: %S (%S) \n", (WCHAR*)bstrPropName, (WCHAR*)bstrPropAddr);
            break;
        }
        case olOutlookDistributionListAddressEntry: // 11
        {
            addEntryPtr->get_Members(&pAaddrEntries);
            sprintf(s, "OUTLOOK DISTRIBUTION LIST: %S - %d members \n", (WCHAR*)bstrPropName, pAaddrEntries->GetCount());
            break;
        }
        default: break;
        }
    }
}

这很好用（我从 Outlook 中检索了所有联系人）。

我的问题是解析名称（我需要按文本过滤），只列出匹配的用户。

我可以加载所有用户并循环播放，但是有很多联系人会很慢

我可以看到有一些方法可以做到这一点，例如 Find 或 Restrict。但我没有成功。

一旦我有了清单，我就有了：

MAPIFolderPtr mapiFolder = list->GetContactsFolder();
if (mapiFolder)
{
    _ItemsPtr folderItems = mapiFolder->Items;
    if (folderItems)
    {
        _Items* pItems;
        BSTR bstrPropID = A2BSTR("*");
        HRESULT hr = folderItems->raw_Restrict(bstrPropID, &pItems);
    }
}

我有两个问题：

只有在 Outlook 本地联系人列表中，我才能获得有效的 MAPIFolderPtr 项（其他列表，例如交换用户返回 NULL）
当我有 MAPIFolderPtr 时，mapiFolder->Items 返回一个有效值（此列表中的联系人数量），但 pItems 为 NULL...

我也试过了

folderItems->Restrict("*")
folderItems->Find(bstrPropID);

但在这两种情况下我都遇到了异常（'条件无效'）

与

IDispatch * pDisp;
folderItems->raw_Find(bstrPropID, &pDisp);

但 pDisp 为 NULL；

对解析 Outlook 联系人列表中的姓名有帮助吗？

谢谢，迭戈

【问题讨论】：

当然 - AddressList.GetContactsFolder 仅当列表基于您邮箱上的联系人文件夹之一时才会返回有效的 MAPIFolder。如果是 GAL 容器，则没有文件夹。
要解析名称，可以使用 Application.Session.CreateRecipient / Recipient.Resolve
感谢您的帮助。现在这可行，但是当只有一个收件人与该模式匹配时...当多个匹配时，我还需要一个联系人列表...我尝试了查找或限制但没有成功，我找不到我的对象必须使用...

标签： c++ outlook

【解决方案1】：

要解析为单个收件人，您可以使用Application.Session.CreateRecipient / Recipient.Resolve。

获得多个匹配项的唯一方法是使用扩展 MAPI（C++ 或 Delphi）并执行 Outlook 在解析名称和获得不明确匹配项时所做的事情 - 对特定容器使用 PR_ANR 限制。 MAPI 通讯簿提供程序不像存储提供程序那样支持 conmlex 限制。 PR_ANR 真的是你最好的选择。

如果使用Redemption（任何语言，我是它的作者）是一个选项，它会公开RDOSession.AddressBook.ResolveNameEx 和RDOAddressList.ResolveNameEx，返回匹配的集合。

【讨论】：

谢谢！阅读文档中的限制，我可以看到：从 IMAPIContainer 我得到一个 IMAPITable: IMAPIContainer::GetContentsTable(ULONG ulFlags, LPMAPITABLE FAR * lppTable);使用表格我可以限制内容： IMAPITable::Restrict(LPSRestriction lpRestriction, ULONG ulFlags);我想 LPSRestriction 有： rt = RES_CONTENT res = SContentRestriction （与自定义数据匹配）但我不知道如何从我的 IMAPISession 或我的 IAddrBook 中获取 IMAPIContainer ......对吗？
你可以从 OOM 中的 Namespace.MAPIOBJECT 获取 IMAPISession，然后使用 IAMPISession::OpenEntry() 传递地址列表条目 id 打开地址列表。

【解决方案2】：

感谢您的帮助，Dmitry，我明白了：

我有我的 addrBook，我得到了根容器 (IAddrBook::OpenEntry)，我得到了一个包含所有地址簿的表 (IABContainer::GetHierarchyTable)

然后我得到容器 (IAddrBook::OpenEntry)，得到内容表 (IABContainer::GetContentsTable) 并应用 PR_ANR 限制来查找字符串，例如“di”（查找 'Diego Doñate' 或 'Diana xxx'）。

【讨论】：