wiasReadMultiple-Funktion (wiamdef.h)
Die wiasReadMultiple-Funktion ruft mehrere Eigenschaftswerte aus einem WIA-Element ab.
Syntax
HRESULT wiasReadMultiple(
[in] BYTE *pWiasContext,
ULONG ulCount,
[in] const PROPSPEC *ps,
[out] PROPVARIANT *pv,
[out, optional] PROPVARIANT *pvOld
);
Parameter
[in] pWiasContext
Zeiger auf einen WIA-Elementkontext.
ulCount
Gibt die Anzahl der zu lesenden Eigenschaften an.
[in] ps
Zeiger auf das erste Element eines Arrays von PROPSPEC-Strukturen , das die zu lesenden Eigenschaften enthält.
[out] pv
Zeiger auf das erste Element eines Arrays von PROPVARIANT-Strukturen . Nach der Rückgabe enthalten diese Strukturen neue Werte für die Eigenschaften.
[out, optional] pvOld
Zeiger auf das erste Element eines Arrays von PROPVARIANT-Strukturen, die zuvor vom Minidriver zugewiesen wurden. Nach der Rückgabe enthält das Array die vorherigen Werte der Eigenschaftendaten. Wenn diese Informationen nicht benötigt werden, kann dieser Parameter auf NULL festgelegt werden.
Rückgabewert
Bei Erfolg gibt die Funktion S_OK zurück.
Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA-Fehlercodes zurück.
Hinweise
Diese Funktion liest mehrere Eigenschaften aus einem WIA-Element. Wenn der Aufruf erfolgreich ist, muss der Minidriver PropVariantClear für jedes Element in dem array aufrufen, das durch den pv-Parameter angegeben wird. Weitere Informationen finden Sie unter IPropertyStorage::ReadMultiple .
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamdef.h (einschließlich Wiamdef.h) |
| Bibliothek | Wiaservc.lib |
| DLL | Wiaservc.dll |