Метод 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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Комментарии

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

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

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета 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).

Требования

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

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

IMFAttributes