wiasGetPropertyAttributes-Funktion (wiamdef.h)

Artikel
02/07/2025

Die wiasGetPropertyAttributes Funktion ruft die Zugriffskennzeichnungen und gültigen Werte für eine Reihe von Eigenschaften ab.

Syntax

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Parameter

[in] pWiasContext

Zeiger auf einen WIA-Elementkontext.

cPropSpec

Gibt die Anzahl der Eigenschaften an.

[in] pPropSpec

Zeigen Sie auf eine PROPSPEC- Struktur, die die Eigenschaften angibt, für die gültige Werte und Zugriffskennzeichnungen abgerufen werden sollen.

pulAccessFlags

Zeigen Sie auf ein Array, das die Zugriffskennzeichnungen für die Eigenschaften enthält.

[out] pPropVar

Zeigen Sie auf ein Array PROPVARIANT- Strukturen, die die gültigen Werte für die Eigenschaften enthalten.

Rückgabewert

Bei Erfolg gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein STANDARDMÄßIGer COM-Fehler oder eine der WIA-Fehlercodeszurückgegeben.

Bemerkungen

Diese Funktion füllt jedes Element des pPropVar Arrays mit einer PROPVARIANT-Struktur aus, die die gültigen Werte für die entsprechende Eigenschaft angibt. Eigenschaften mit der Zugriffsberechtigungskennzeichnung WIA_PROP_NONE keine gültigen Werte für diese Eigenschaft aufweisen. Der Datentyp für die gültigen Werte dieser Eigenschaften ist VT_EMPTY.

Mindestens ein WIA_PROP_Xxx Eigenschaftsattribute und Zugriffskennzeichnungen können in jedem Element des pulAccessFlags Arrays zurückgegeben werden.

Wenn die Eigenschaft über einen Bereich gültiger Werte verfügt, können die Werte anhand des pPropVar- Parameters nach Abschluss dieser Funktion bestimmt werden. Der pPropVar Parameter gibt ein Array von PROPVARIANT-Strukturen an.

Auf gültige Ganzzahl- und Gleitkommawerte in einem Bereich wird mithilfe der folgenden Indexkonstanten zugegriffen.

Gültiger Wertindex	Beschreibung
WIA_RANGE_MIN	Minimalwert
WIA_RANGE_NOM	Nennwert
WIA_RANGE_MAX	Maximalwert
WIA_RANGE_STEP	Inkrementierungswert

Auf gültige Listenwerte wird mithilfe der folgenden Indexkonstanten zugegriffen.

Gültiger Wertindex	Beschreibung
WIA_LIST_COUNT	Anzahl gültiger Listenwerte, ohne den Nominalwert zu zählen
WIA_LIST_NOM	Nennwert
WIA_LIST_VALUES	Index zum ersten gültigen Wert

Auf gültige Bitweise-Flagwerte wird mithilfe der folgenden Indexkonstanten zugegriffen.

Gültiger Wertindex	Beschreibung
WIA_FLAG_NOM	Nennwert
WIA_FLAG_VALUES	Alle gültigen Flags werden von einem OR-Operator miteinander verknüpft.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	wiamdef.h (include Wiamdef.h)
Library	Wiaservc.lib
DLL-	Wiaservc.dll

Freigeben über