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


Метод ISearchBoxInfo::GetCondition (shobjidl.h)

Извлекает содержимое поля поиска в виде объекта ICondition .

Синтаксис

HRESULT GetCondition(
  [in]  REFIID riid,
  [out] void   **ppv
);

Параметры

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_ICondition.

[out] ppv

Тип: void**

При успешном возвращении этого метода содержит указатель интерфейса, запрошенный в riid. Обычно это ICondition.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

В отличие от текстовой строки, полученной ISearchBoxInfo::GetText, GetCondition извлекает те же сведения, что и структурированный объект, методы которого можно использовать для анализа строки поиска и управления ими.

Мы рекомендуем использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кодирования в riid , которая может привести к непредвиденным результатам.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl.h

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

ISearchBoxInfo