IMsgStore::CompareEntryIDs

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Сравнивает два идентификатора записи, чтобы определить, ссылаются ли они на одну и ту же запись в хранилище сообщений. MAPI передает этот вызов поставщику услуг только в том случае, если этот поставщик обрабатывает уникальные идентификаторы (UID) в обоих сравниваемых идентификаторах записей.

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

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

Замечания

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

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

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

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

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

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

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

См. также

MAPIUID

IMsgStore: IMAPIProp

Mfcmapi (en) � ��

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