Metodo IWiaItem2::CheckExtension

Verifica se un'estensione specificata è disponibile nel computer e può essere usata dal metodo IWiaItem2::GetExtension .

Sintassi

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

Parametri

lFlags [in]

Tipo: LONG

Attualmente inutilizzato. Deve essere impostato su zero.

bstrName [in]

Tipo: BSTR

Specifica il nome dell'estensione.

riidExtensionInterface [in]

Tipo: REFIID

Attualmente inutilizzato.

pbExtensionExists [out]

Tipo: BOOL*

Riceve un puntatore a un valore BOOL.

FALSE

L'estensione specificata non è disponibile.

VERO

L'estensione specificata è disponibile.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Usando questo metodo, le applicazioni possono verificare se un'estensione è disponibile prima di chiamare il metodo IWiaItem2::GetExtension . Inoltre, l'applicazione può controllare quali estensioni sono disponibili senza creare co-creazione ognuno di essi e quindi decidere quale usare.

Esempio

CheckImgFilter verifica se il driver ha un filtro di elaborazione delle immagini. Prima di chiamare il componente di anteprima, un'applicazione deve assicurarsi che il driver disponga di un filtro di elaborazione delle immagini.

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;

}

Requisiti