wiasGetPropertyAttributes 函式 (wiamdef.h)

wiasGetPropertyAttributes 函式會擷取一組屬性的存取旗標和有效值。

語法

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

參數

[in] pWiasContext

WIA 專案內容的指標。

cPropSpec

指定屬性數目。

[in] pPropSpec

PROPSPEC 結構的指標，指出要取得有效值和存取旗標的屬性。

pulAccessFlags

陣列的指標，其中包含屬性的存取旗標。

[out] pPropVar

PROPVARIANT 結構的陣列指標，其中包含屬性的有效值。

傳回值

成功時，函式會傳回S_OK。

如果函式失敗，它會傳回標準 COM 錯誤或其中一個 WIA 錯誤碼。

備註

此函式會以 PROPVARIANT 結構填滿 pPropVar 陣列的每個元素，以指定對應屬性的有效值。 具有訪問許可權旗標的屬性WIA_PROP_NONE沒有該屬性的有效值。 這些屬性有效值的數據類型VT_EMPTY。

pulAccessFlags 陣列的每個元素可以傳回一或多個WIA_PROP_Xxx屬性屬性和存取旗標。

如果屬性具有有效值的範圍，可以在完成此函式時透過 pPropVar 參數來判斷值。 pPropVar 參數會指定 PROPVARIANT 結構的陣列。

使用下列索引常數來存取範圍中有效的整數和浮點值。

有效值索引	Description
WIA_RANGE_MIN	最小值
WIA_RANGE_NOM	小數值
WIA_RANGE_MAX	最大值
WIA_RANGE_STEP	遞增值

您可以使用下列索引常數來存取有效的清單值。

有效值索引	Description
WIA_LIST_COUNT	有效清單值的計數，不計算名義值
WIA_LIST_NOM	小數值
WIA_LIST_VALUES	索引至第一個有效值

您可以使用下列索引常數來存取有效的位旗標值。

有效值索引	Description
WIA_FLAG_NOM	小數值
WIA_FLAG_VALUES	OR 運算符會將所有有效的旗標聯結在一起

規格需求

需求	值
目標平台	桌面
標頭	wiamdef.h (包含Wiamdef.h)
程式庫	Wiaservc.lib
Dll	Wiaservc.dll