IAddrBook::CompareEntryIDs
Область применения: Outlook 2013 | Outlook 2016
Сравнивает два идентификатора записи, принадлежащие конкретному поставщику адресной книги, чтобы определить, ссылаются ли они на один и тот же объект адресной книги.
HRESULT CompareEntryIDs(
ULONG cbEntryID1,
LPENTRYID lpEntryID1,
ULONG cbEntryID2,
LPENTRYID lpEntryID2,
ULONG ulFlags,
ULONG FAR * lpulResult
);
Параметры
cbEntryID1
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID1 .
lpEntryID1
[в] Указатель на первый идентификатор записи для сравнения.
cbEntryID2
[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID2 .
lpEntryID2
[в] Указатель на второй идентификатор записи для сравнения.
ulFlags
[in] ���������������; ������ ���� ����� ����.
lpulResult
[out] Указатель на результат сравнения. Содержимое lpulResult имеет значение TRUE, если два идентификатора записи ссылаются на один и тот же объект; В противном случае для содержимого будет задано значение FALSE.
Возвращаемое значение
S_OK
����� ������� � ������ ��������� ��������� ��� ��������.
MAPI_E_UNKNOWN_ENTRYID
Один или оба идентификатора записи, переданные с параметрами lpEntryID1 или lpEntryID2 , не распознаются ни одним поставщиком адресной книги.
Замечания
Клиентские приложения и поставщики услуг вызывают метод CompareEntryIDs для сравнения двух идентификаторов записей, принадлежащих одному поставщику адресной книги, чтобы определить, ссылаются ли они на один и тот же объект. Функция CompareEntryIDs полезна, так как объект может иметь несколько допустимых идентификаторов записи. Такая ситуация может возникнуть, например, после установки новой версии поставщика адресной книги.
MAPI передает этот вызов поставщику адресной книги, который отвечает за идентификаторы записей, определяя соответствующий поставщик путем сопоставления структуры MAPIUID в идентификаторах записей со структурой MAPIUID , зарегистрированной поставщиком.
Если два идентификатора записи ссылаются на один и тот же объект, compareEntryIDs задает для содержимого параметра lpulResult значение TRUE; Если они ссылаются на разные объекты, compareEntryIDs задает для содержимого значение FALSE. В любом случае CompareEntryIDs возвращает S_OK. Если compareEntryIDs возвращает ошибку, которая может возникнуть, если ни один поставщик адресной книги не зарегистрировал структуру MAPIUID , соответствующую структуре в идентификаторах записей, клиенты и поставщики не должны предпринимать никаких действий на основе результата сравнения. Вместо этого они должны использовать наиболее консервативный подход к выполняемой деятельности.