funzione wiasReadPropStr (wiamdef.h)
La funzione wiasReadPropStr recupera un valore della proprietà stringa da un elemento WIA.
Sintassi
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
Parametri
[in] pWiasContext
Puntatore a un contesto di elemento WIA.
propid
Specifica l'identificatore della proprietà.
[out] pbstr
Puntatore a una posizione di memoria che riceve il primo byte del valore stringa della proprietà.
[out, optional] pbstrOld
Puntatore a una posizione di memoria che riceve il primo byte del valore precedente della proprietà. Se queste informazioni non sono necessarie, impostare questo parametro su NULL.
bMustExist
Indica se la proprietà deve esistere. Se impostato su TRUE, la proprietà deve esistere; se impostato su FALSE, la proprietà non deve esistere.
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 degli errori WIA_ERROR_XXX (descritto nella documentazione di Microsoft Windows SDK).
Commenti
Al termine del minidriver usando la stringa ricevuta da questa funzione, deve deallocare la memoria usata per la stringa.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows Me e in Windows XP e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamdef.h (include Wiamdef.h) |
| Libreria | Wiaservc.lib |
| DLL | Wiaservc.dll |