Metode IWiaItem2::CheckExtension

Memeriksa apakah ekstensi tertentu tersedia di komputer dan dapat digunakan oleh metode IWiaItem2::GetExtension .

Sintaks

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

Parameter

lFlags [in]

Jenis: LONG

Saat ini tidak digunakan. Harus diatur ke nol.

bstrName [in]

Jenis: BSTR

Menentukan nama ekstensi.

riidExtensionInterface [in]

Jenis: REFIID

Saat ini tidak digunakan.

pbExtensionExists [out]

Jenis: BOOL*

Menerima pointer ke BOOL.

PALSU

Ekstensi yang ditentukan tidak tersedia.

BENAR

Ekstensi yang ditentukan tersedia.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Dengan menggunakan metode ini, aplikasi dapat memeriksa apakah ekstensi tersedia sebelum memanggil metode IWiaItem2::GetExtension . Selain itu, aplikasi dapat memeriksa ekstensi mana yang tersedia tanpa membuat masing-masing ekstensi bersama, dan kemudian memutuskan mana yang akan digunakan.

Contoh

CheckImgFilter memeriksa apakah driver memiliki filter pemrosesan gambar. Sebelum memanggil komponen pratinjau, aplikasi harus memastikan bahwa driver memiliki filter pemrosesan gambar.

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;

}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Wia.h
IDL	Wia.idl