Freigeben über


wiasReadPropStr-Funktion (wiamdef.h)

Die wiasReadPropStr-Funktion ruft einen Zeichenfolgeneigenschaftswert aus einem WIA-Element ab.

Syntax

HRESULT wiasReadPropStr(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           BSTR   *pbstr,
  [out, optional] BSTR   *pbstrOld,
                  BOOL   bMustExist
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

propid

Gibt den Eigenschaftenbezeichner an.

[out] pbstr

Zeiger auf einen Speicherspeicherort, der das erste Byte des Zeichenfolgenwerts der Eigenschaft empfängt.

[out, optional] pbstrOld

Zeiger auf einen Speicherspeicherort, der das erste Byte des vorherigen Werts der Eigenschaft empfängt. Wenn diese Informationen nicht benötigt werden, legen Sie diesen Parameter auf NULL fest.

bMustExist

Gibt an, ob die Eigenschaft vorhanden sein muss. Wenn auf TRUE festgelegt ist, muss die Eigenschaft vorhanden sein. wenn auf FALSE festgelegt ist, muss die Eigenschaft nicht vorhanden sein.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück. Wenn die Funktion fehlschlägt, gibt sie einen COM-Standardfehler oder einen der WIA_ERROR_XXX Fehler zurück (in der Microsoft Windows SDK-Dokumentation beschrieben).

Hinweise

Wenn der Minidriver die Zeichenfolge verwendet hat, die er von dieser Funktion empfangen hat, muss er den für die Zeichenfolge verwendeten Arbeitsspeicher umlagern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Microsoft Windows Me und in Windows XP und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile wiamdef.h (einschließlich Wiamdef.h)
Bibliothek Wiaservc.lib
DLL Wiaservc.dll

Weitere Informationen

wiasReadPropBin

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasWritePropStr