Interfaz IScanProfile
La interfaz IScanProfile representa un único perfil de examen y permite a las aplicaciones establecer y obtener las propiedades del perfil.
Miembros
La interfaz IScanProfile hereda de la interfaz IDispatch . IScanProfile también tiene estos tipos de miembros:
Métodos
La interfaz IScanProfile tiene estos métodos.
| Método | Descripción |
|---|---|
| GetAllPropIDs | Obtiene todos los identificadores de propiedad disponibles en un perfil. |
| GetDeviceID | Devuelve el identificador del dispositivo. |
| GetGUID | Devuelve el GUID del perfil. |
| Getitem | Obtiene el GUID de la categoría del elemento WIA 2.0 al que está asociado el perfil. |
| GetName | Obtiene el nombre descriptivo del perfil. |
| GetNumPropIDS | Obtiene el número de identificadores de propiedad de un perfil. |
| GetProperty | Obtiene el valor de las propiedades secundarias especificadas en el <Properties> elemento de un perfil de examen. |
| IsDefault | Obtiene un valor que indica si el perfil es el perfil de examen predeterminado de un dispositivo IWiaItem2 asociado. |
| RemoveProperty | Quita una lista especificada de propiedades secundarias en el <Properties> elemento de un perfil de examen. |
| Guardar | Guarda los cambios en un perfil en el disco. |
| SetItem | Establece el GUID de la categoría del elemento WIA 2.0 al que está asociado el perfil. |
| SetName | Establece el nombre descriptivo del perfil. |
| SetProperty | Establece el valor de las propiedades secundarias especificadas en el <Properties> elemento de un perfil de examen. |
Comentarios
Cualquier dispositivo IWiaItem2 puede tener un perfil de examen. Sin embargo, los elementos IWiaItem2 de tipos WIA_CATEGORY_FINISHED_FILE y WIA_CATEGORY_ROOT no pueden tener perfiles.
Si se guarda un perfil de examen mediante el método IScanProfile::Save , se almacena como un archivo XML en %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.
Para crear una instancia de un objeto IScanProfile , use el método IScanProfileMgr::CreateProfile . Para obtener una referencia a un perfil de examen que ya se ha guardado en el disco, use el método IScanProfileMgr::OpenProfile .
Todos los perfiles de examen tienen los siguientes elementos: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, y <Properties>. El perfil predeterminado de un dispositivo también tiene un <Default> elemento .
Los <ProfileGUID> elementos y <DeviceID> no se pueden cambiar después de crear el perfil. Los valores del <ProfileName> elemento y el <WiaItem> elemento se pueden cambiar después de crear el perfil. El <Default> elemento se puede agregar o eliminar. Esto se puede hacer mediante programación con los métodos IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault . Los usuarios también pueden cambiar estas propiedades a través del método IScanProfileUI::ScanProfileDialog .
El <Properties> elemento contiene <Property> elementos secundarios. Úselos para agregar cualquier propiedad de dispositivo o elemento de WIA 2.0 al perfil. También puede desarrollar sus propios hijos de adquisición de <Property> imágenes. Esto hace que el esquema de perfil de examen sea extensible. (Para obtener más información sobre cómo extender el esquema, vea Definir propiedades personalizadas, IScanProfile::GetProperty e IScanProfile::SetProperty).
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2008 [solo aplicaciones de escritorio] |
| IDL |
|
Consulte también