IScanProfileMgr::CreateProfile 方法

创建一个空的扫描配置文件,并将其与扫描仪或其他 Windows 映像采集 (WIA) 2.0 项相关联。

语法

HRESULT CreateProfile(
  [in]  BSTR         bstrDeviceID,
  [in]  BSTR         bstrName,
  [in]  GUID         guidCategory,
  [out] IScanProfile **ppScanProfile
);

参数

bstrDeviceID [in]

类型: BSTR

设备或 WIA 2.0 项的 ID。

bstrName [in]

类型: BSTR

新配置文件的友好名称。

guidCategory [in]

类型: GUID

设备或 WIA 2.0 项类别的 GUID。 这必须是WIA_IPA_ITEM_CATEGORY常量之一。

ppScanProfile [out]

类型: IScanProfile**

指向新配置文件的指针的地址。

返回值

类型: HRESULT

如果此方法成功,则返回 S_OK。 否则,它将返回 HRESULT 错误代码。

备注

IScanProfileMgr::CreateProfile 将指定的设备与新的扫描配置文件相关联。

IScanProfileMgr::CreateProfile 为新配置文件自动生成 GUID。 使用 GetGUID 获取 GUID

当多个 IScanProfileMgr 对象可能同时创建或删除配置文件时,请使用 IScanProfileMgr ::Refresh 方法。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
Scanprofilemgr.h
IDL
Scanprofiles.idl

另请参阅

IScanProfileMgr

扫描配置文件架构