IScanProfile 介面

IScanProfile介面代表單一掃描設定檔，並可讓應用程式設定並取得設定檔的屬性。

成員

IScanProfile介面繼承自IDispatch介面。 IScanProfile 也有下列類型的成員：

• 方法

方法

IScanProfile介面具有這些方法。

方法	Description
GetAllPropIDs	取得設定檔中的所有可用屬性識別碼。
GetDeviceID	傳回裝置的識別碼。
GetGUID	傳回設定檔的 GUID。
GetItem	取得與設定檔相關聯之 WIA 2.0 專案的類別 GUID。
GetName	取得設定檔的易記名稱。
GetNumPropIDS	取得設定檔中的屬性識別碼數目。
GetProperty	取得掃描設定檔專案中指定子屬性 <Properties> 的值。
IsDefault	取得值，指出設定檔是否為相關聯 IWiaItem2 裝置的預設掃描設定檔。
RemoveProperty	移除掃描設定檔專案中的指定子屬性 <Properties> 清單。
儲存	將設定檔的變更儲存至磁片。
SetItem	設定設定檔相關聯之 WIA 2.0 專案類別的 GUID。
SetName	設定設定檔的易記名稱。
SetProperty	在掃描設定檔的 元素中 <Properties> 設定指定子屬性的值。

 

備註

任何 IWiaItem2 裝置都可以有掃描設定檔。 不過，WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_ROOT類型的 IWiaItem2 專案不能有設定檔。

如果使用 IScanProfile：：Save 方法儲存掃描設定檔，則會儲存為 %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles 的 XML 檔案。

若要建立 IScanProfile 物件的實例，請使用 IScanProfileMgr：：CreateProfile 方法。 若要取得已儲存至磁片的掃描設定檔參考，請使用 IScanProfileMgr：：OpenProfile 方法。

所有掃描設定檔都有下列元素： <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem> 、 和 <Properties> 。 裝置的預設設定檔也有 <Default> 元素。

建立 <ProfileGUID> 設定檔之後，就無法變更 和 <DeviceID> 元素。 建立設定檔之後，可以變更專案和 <WiaItem> 元素的值 <ProfileName> 。 <Default>您可以新增或刪除專案。 這可以透過 IScanProfile：：SetName、 IScanProfile：：SetItem和 IScanProfileMgr：：SetDefault 方法以程式設計方式完成。 使用者也可以透過 IScanProfileUI：：ScanProfileDialog 方法來變更這些屬性。

元素 <Properties> 包含 <Property> 子系。 使用這些屬性可將任何 WIA 2.0 專案或裝置屬性新增至設定檔。 您也可以開發自己的映射取得 <Property> 子系。 這樣可延伸掃描設定檔架構。 (如需擴充架構的詳細資訊，請參閱 定義自訂屬性、 IScanProfile：：GetProperty和 IScanProfile：：SetProperty.)

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
Idl	Scanprofiles.idl

另請參閱

IDispatch

掃描設定檔架構