IMAPISupport::CompareEntryIDs

Статья
04/04/2023

Область применения: 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] Указатель на результат сравнения. ЗНАЧЕНИЕ TRUE, если два идентификатора записи ссылаются на один и тот же объект; в противном случае — FALSE.

Возвращаемое значение

S_OK

Сравнение прошло успешно.

MAPI_E_UNKNOWN_ENTRYID

Один или оба идентификатора записи, указанные в качестве параметров, не относятся к допустимым объектам, возможно, потому, что они в настоящее время нераскрыты и недоступны.

Замечания

Метод IMAPISupport::CompareEntryIDs реализован для объектов поддержки адресной книги и хранилища сообщений. CompareEntryIDs сравнивает два идентификатора записи, принадлежащие одному поставщику услуг, чтобы определить, ссылаются ли они на один и тот же объект. MAPI извлекает часть MAPIUID из идентификаторов входа, чтобы определить поставщика услуг, ответственного за объекты. Затем MAPI вызывает метод CompareEntryIDs объекта входа для выполнения сравнения.

Примечания для вызывающих методов

Функция CompareEntryIDs полезна, так как объект может иметь несколько допустимых идентификаторов записи. Такая ситуация может возникнуть, например, после установки новой версии поставщика услуг.

Если функция CompareEntryIDs возвращает ошибку, не следует предпринимать никаких действий на основе результата сравнения. Вместо этого используйте самый консервативный подход. СравнениеEntryID может завершиться ошибкой, если, например, один или оба идентификатора записи содержат недопустимую структуру MAPIUID .

См. также

MAPIUID

IMAPISupport: IUnknown

Поделиться через