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

Zeigen Sie auf das erste Element eines Arrays PROPSPEC- Strukturen, die die zu lesenden Eigenschaften enthalten.

[out] pv

Zeigen Sie auf das erste Element eines Arrays PROPVARIANT- Strukturen. Bei 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. Beim Zurückgeben enthält das Array die vorherigen Werte der Eigenschaftsdaten. 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, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.

Bemerkungen

Diese Funktion liest mehrere Eigenschaften aus einem WIA-Element. Wenn der Aufruf erfolgreich ist, muss der Minidriver PropVariantClear- für jedes Element im Array aufrufen, das durch den parameter pv angegeben wird. Weitere Informationen finden Sie unter IPropertyStorage::ReadMultiple.

Anforderungen

Siehe auch

wiasWriteMultiple