Метод IMFAttributes::CompareItem (mfobjects.h)

Запрашивает, равно ли значение сохраненного атрибута указанному атрибуту PROPVARIANT.

Синтаксис

HRESULT CompareItem(
  [in]  REFGUID        guidKey,
  [in]  REFPROPVARIANT Value,
  [out] BOOL           *pbResult
);

Параметры

[in] guidKey

GUID, определяющий, какое значение следует запрашивать.

[in] Value

PROPVARIANT , содержащий сравниваемое значение.

[out] pbResult

Получает логическое значение, указывающее, соответствует ли атрибут значению, заданному в поле Value. См. заметки. Этот параметр не должен иметь значение NULL. Если этот параметр имеет значение NULL, происходит нарушение доступа.

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

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Метод выполнен успешно.

Комментарии

Метод присваивает pbResult значение FALSE по любой из следующих причин:

• Не найден атрибут, ключ которого соответствует ключу, указанному в guidKey.
• Тип PROPVARIANT атрибута не соответствует типу, указанному в параметре Value.
• Значение атрибута не соответствует значению, указанному в поле Значение.
• Метод завершается ошибкой.

В противном случае метод присваивает pbResult значение TRUE.

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK для Windows Media Format 11:

• Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
• Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления за октябрь 2006 г. для Windows XP Media Center Edition).

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа	Windows
Header	mfobjects.h (включая Mfidl.h)
Библиотека	Mfuuid.lib

См. также раздел

Атрибуты и свойства

IMFAttributes