Метод IWiaItem2::CheckExtension

Статья
06/12/2023

Проверяет, доступно ли указанное расширение на компьютере и может ли его использовать метод IWiaItem2::GetExtension .

Синтаксис

HRESULT CheckExtension(
  [in]  LONG   lFlags,
  [in]  BSTR   bstrName,
  [in]  REFIID riidExtensionInterface,
  [out] BOOL   *pbExtensionExists
);

Параметры

lFlags [in]

Тип: LONG

В настоящее время не используется. Значение должно быть равно нулю.

bstrName [in]

Тип: BSTR

Указывает имя расширения.

riidExtensionInterface [in]

Тип: REFIID

В настоящее время не используется.

pbExtensionExists [out]

Тип: BOOL*

Получает указатель на BOOL.

ЛОЖНЫХ

Указанное расширение недоступно.

ИСТИННЫЙ

Доступно указанное расширение.

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

Тип: HRESULT

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

С помощью этого метода приложения могут проверка, доступно ли расширение перед вызовом метода IWiaItem2::GetExtension. Кроме того, приложение может проверка, какие расширения доступны без совместного создания каждого из них, а затем решить, какое из них использовать.

Примеры

CheckImgFilter проверяет, есть ли у драйвера фильтр обработки изображений. Перед вызовом компонента предварительной версии приложение должно убедиться, что драйвер имеет фильтр обработки изображений.

HRESULT
CheckImgFilter(
   IN  IWiaItem2 *pWiaItem2,
   OUT BOOL      *pbHasImgFilter)
{
   HRESULT     hr = S_OK;

   if (!pWiaItem2 || !pbHasImgFilter)
   {
      hr = E_INVALIDARG;
   }

   if (SUCCEEDED(hr))
   {
     *pbHasImgFilter = FALSE;
   }

   if (SUCCEEDED(hr))
   {
      BSTR    bstrFilterString = SysAllocString(WIA_IMAGEPROC_FILTER_STR);

      if (bstrFilterString)
      {
         hr = pWiaItem2->CheckExtension(0,
                                        bstrFilterString,
                                        IID_IWiaSegmentationFilter,
                                        pbHasImgFilter);

         SysFreeString(bstrFilterString);
         bstrFilterString = NULL;
      }
      else
      {
         hr = E_OUTOFMEMORY;
      }
   }

   return hr;

}

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Заголовок	Wia.h
IDL	Wia.idl

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