IScanProfile::Save メソッド

プロファイルへの変更をディスクに保存します。

構文

HRESULT Save();

パラメーター

このメソッドにはパラメーターはありません。

戻り値

種類: HRESULT

このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

解説

保存されたスキャン プロファイルは、%USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles に格納されている XML ファイルです。

複数のプロセスが IScanProfile オブジェクトに書き込む場合、 IScanProfile::Save last を呼び出すプロセスは、変更が保存される唯一のプロセスです。

IScanProfile::Save メソッドは、保存する前にプロファイルを検証します。 プロファイルに関連付けられている Windows Image Acquisition (WIA) 2.0 項目のカテゴリがWIA_CATEGORY_FLATBEDまたはWIA_CATEGORY_FEEDERでない限り、プロファイルは常に有効と見なされます。 カテゴリがWIA_CATEGORY_FLATBEDまたはWIA_CATEGORY_FEEDERの場合、プロパティがプロファイルに含まれている場合は、アイテムに対して次のプロパティが有効である必要があります。

WIA_IPS_BRIGHTNESS

WIA_IPS_CONTRAST

WIA_IPA_DATATYPE

WIA_IPS_XRES

WIA_IPA_FORMAT

さらに、カテゴリがWIA_CATEGORY_FEEDERされている場合は、プロファイルに存在する場合は、WIA_IPS_PAGE_SIZE プロパティが有効である必要があります。 これらのプロパティの詳細については、「 スキャナー WIA 項目プロパティ定数」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
ヘッダー	Scanprofile.h
IDL	Scanprofiles.idl

関連項目

IScanProfile

スキャン プロファイル スキーマ