Método IScanProfileMgr::CreateProfile

Crea un perfil de examen vacío y lo asocia a un escáner u otro elemento de adquisición de imágenes de Windows (WIA) 2.0.

Sintaxis

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

Parámetros

bstrDeviceID [in]

Tipo: BSTR

Identificador del dispositivo o del elemento WIA 2.0.

bstrName [in]

Tipo: BSTR

Nombre descriptivo del nuevo perfil.

guidCategory [in]

Tipo: GUID

GUID de la categoría del dispositivo o del elemento WIA 2.0. Debe ser una de las constantes WIA_IPA_ITEM_CATEGORY.

ppScanProfile [out]

Tipo: IScanProfile**

Dirección de un puntero al nuevo perfil.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

IScanProfileMgr::CreateProfile asocia el dispositivo especificado con el nuevo perfil de examen.

IScanProfileMgr::CreateProfile genera automáticamente un GUID para el nuevo perfil. Obtenga el GUID con GetGUID.

Use el método IScanProfileMgr::Refresh cuando más de un objeto IScanProfileMgr podría crear o eliminar perfiles al mismo tiempo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Scanprofilemgr.h
IDL	Scanprofiles.idl

Consulte también

IScanProfileMgr

Esquema de perfil de examen