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 |