funzione wiasReadPropStr (wiamdef.h)

Articolo
03/05/2024

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

Condividi tramite