Funzione wiasReadMultiple (wiamdef.h)
La funzione wiasReadMultiple recupera più valori di proprietà da un elemento wiaa.
Sintassi
HRESULT wiasReadMultiple(
[in] BYTE *pWiasContext,
ULONG ulCount,
[in] const PROPSPEC *ps,
[out] PROPVARIANT *pv,
[out, optional] PROPVARIANT *pvOld
);
Parametri
[in] pWiasContext
Puntatore a un contesto di elemento WIA.
ulCount
Specifica il numero di proprietà da leggere.
[in] ps
Puntatore al primo elemento di una matrice di strutture PROPSPEC, contenente le proprietà da leggere.
[out] pv
Puntatore al primo elemento di una matrice di strutture PROPVARIANT. Al termine, queste strutture contengono nuovi valori per le proprietà.
[out, optional] pvOld
Puntatore al primo elemento di una matrice di strutture PROPVARIANT precedentemente allocate dal minidriver. Al termine della restituzione, la matrice contiene i valori precedenti dei dati della proprietà. Se queste informazioni non sono necessarie, questo parametro può essere impostato su NULL.
Valore restituito
In caso di esito positivo, la funzione restituisce S_OK.
Se la funzione ha esito negativo, restituisce un errore COM standard o uno dei codici di errore wia .
Osservazioni
Questa funzione legge più proprietà da un elemento WIA. Quando la chiamata ha esito positivo, il minidriver deve chiamare PropVariantClear su ogni elemento nella matrice specificata dal parametro pv. Per altre informazioni, vedere IPropertyStorage::ReadMultiple.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | wiamdef.h (include Wiamdef.h) |
| libreria | Wiaservc.lib |
| dll | Wiaservc.dll |