c++ - C++ 应用程序中的 Outlook MAPI : Find contacts by name

Question

我有一个 C++ 应用程序来检索 Outlook 联系人:(本地和交换)用户和通讯组列表)

我通过使用获得了一个接口(interface)文件“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 项目(其他列表如 exchange 用户返回 NULL)

• 当我有 MAPIFolderPtr 时，mapiFolder->Items 返回一个有效值(此列表中的联系人数量)，但 pItems 为 NULL...

我也试过

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

但我在这两种情况下都遇到了异常(“条件无效”)

和

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

但 pDisp 为 NULL；

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

谢谢，迭戈

Answer 1

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

获得多个匹配项的唯一方法是使用扩展 MAPI(C++ 或 Delphi)并执行 Outlook 在解析名称和获得不明确匹配项时所做的操作 - 使用 PR_ANR对特定容器的限制。 MAPI 地址簿提供程序不像商店提供程序那样支持复合限制。 PR_ANR 确实是您最好的选择。

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