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

Weitere Informationen

wiasWriteMultiple