wiasGetPropertyAttributes-Funktion (wiamdef.h)

Die wiasGetPropertyAttributes-Funktion ruft die Zugriffsflags 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

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

pulAccessFlags

Zeiger auf ein Array, das die Zugriffsflags für die Eigenschaften enthält.

[out] pPropVar

Zeiger auf ein Array von PROPVARIANT-Strukturen , das die gültigen Werte für die Eigenschaften enthält.

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-Fehlercodes zurück.

Hinweise

Diese Funktion füllt jedes Element des pPropVar-Arrays mit einer PROPVARIANT-Struktur, die die gültigen Werte für die entsprechende Eigenschaft angibt. Eigenschaften mit dem Zugriffsberechtigungsflag 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.

Ein oder mehrere der WIA_PROP_Xxx Eigenschaftenattribute und Zugriffsflags 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 nach Abschluss dieser Funktion über den pPropVar-Parameter bestimmt werden. Der pPropVar-Parameter gibt ein Array von PROPVARIANT-Strukturen an.

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

Gültiger Wertindex	BESCHREIBUNG
WIA_RANGE_MIN	Mindestwert
WIA_RANGE_NOM	Nennwert
WIA_RANGE_MAX	Maximalwert
WIA_RANGE_STEP	Inkrementwert

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

Gültiger Wertindex	BESCHREIBUNG
WIA_LIST_COUNT	Anzahl gültiger Listenwerte ohne Nennwert
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 durch einen OR-Operator zusammengeführt.

Anforderungen

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