Condividi tramite


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

Vedi anche

wiasReadPropBin

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasWritePropStr