wiasReadPropGuid-Funktion (wiamdef.h)

2025-02-07

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

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

[out, optional] pguidValOld

Zeigen Sie 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 dieser Wert auf TRUE-festgelegt ist, muss die Eigenschaft vorhanden sein; wenn dieser Wert 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, wird ein STANDARDMÄßIGer COM-Fehler oder einer der WIA_ERROR_XXX Fehler zurückgegeben (in der Microsoft Windows SDK-Dokumentation beschrieben).