IWiaItem2::CheckExtension-Methode
Überprüft, ob eine angegebene Erweiterung auf dem Computer verfügbar ist und von der IWiaItem2::GetExtension-Methode verwendet werden kann.
Syntax
HRESULT CheckExtension(
[in] LONG lFlags,
[in] BSTR bstrName,
[in] REFIID riidExtensionInterface,
[out] BOOL *pbExtensionExists
);
Parameter
-
lFlags [in]
-
Typ: LONG
Derzeit nicht verwendet. Sollte auf Null festgelegt werden.
-
bstrName [in]
-
Typ: BSTR
Gibt den Namen der Erweiterung an.
-
riidExtensionInterface [in]
-
Typ: REFIID
Derzeit nicht verwendet.
-
pbExtensionExists [out]
-
Typ: BOOL*
Empfängt einen Zeiger auf eine BOOL.
-
FALSE
-
Die angegebene Erweiterung ist nicht verfügbar.
-
STIMMT
-
Die angegebene Erweiterung ist verfügbar.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Bemerkungen
Mit dieser Methode können Anwendungen überprüfen, ob eine Erweiterung verfügbar ist, bevor sie die IWiaItem2::GetExtension-Methode aufrufen. Außerdem kann die Anwendung überprüfen, welche Erweiterungen verfügbar sind, ohne sie gemeinsam zu erstellen, und dann entscheiden, welche Erweiterungen verwendet werden sollen.
Beispiele
CheckImgFilter überprüft, ob der Treiber über einen Bildverarbeitungsfilter verfügt. Vor dem Aufrufen der Vorschaukomponente sollte eine Anwendung sicherstellen, dass der Treiber über einen Bildverarbeitungsfilter verfügt.
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;
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| IDL |
|