IMAPISession::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

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

Замечания

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

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

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

Если функция CompareEntryIDs возвращает ошибку, не следует предпринимать никаких действий на основе результата сравнения. Вместо этого используйте самый консервативный подход. СравнениеEntryID может завершиться ошибкой, если, например, один или оба идентификатора записи содержат недопустимый ИДЕНТИФИКАТОР MAPIUID.

Справочные материалы по MFCMAPI

Пример кода MFCMAPI указан в приведенной ниже таблице.

Файл	Функция	Comment
BaseDialog.cpp	CbaseDialog::OnCompareEntryIDs	MFCMAPI использует метод IMAPISession::CompareEntryIDs для сравнения двух идентификаторов записей, которые вводит пользователь.

См. также

MAPIUID

IMAPISession: IUnknown

Mfcmapi (en) � ��

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