wiasReadPropGuid-Funktion (wiamdef.h)

Die wiasReadPropGuid-Funktion ruft einen GUID-Eigenschaftswert aus einem WIA-Element ab.

Syntax

HRESULT wiasReadPropGuid(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           GUID   *pguidVal,
  [out, optional] GUID   *pguidValOld,
                  BOOL   bMustExist
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

propid

Gibt den Eigenschaftenbezeichner an.

[out] pguidVal

Zeiger auf einen Speicherspeicherort, der den GUID-Eigenschaftswert empfängt.

[out, optional] pguidValOld

Zeiger auf einen Speicherspeicherort, der den vorherigen Wert der GUID-Eigenschaftsdaten empfängt. Wenn diese Informationen nicht benötigt werden, kann dieser Parameter auf NULL festgelegt werden.

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).

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile wiamdef.h (einschließlich Wiamdef.h)
Bibliothek Wiaservc.lib
DLL Wiaservc.dll

Weitere Informationen

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid