Interface IScanProfile

A interface IScanProfile representa um único perfil de verificação e permite que os aplicativos definam e obtenham as propriedades do perfil.

Membros

A interface IScanProfile herda da interface IDispatch . O IScanProfile também tem esses tipos de membros:

Métodos

A interface IScanProfile tem esses métodos.

Método Descrição
GetAllPropIDs Obtém todas as IDs de propriedade disponíveis em um perfil.
GetDeviceID Retorna a ID do dispositivo.
Getguid Retorna o GUID do perfil.
Getitem Obtém o GUID da categoria do item WIA 2.0 ao qual o perfil está associado.
GetName Obtém o nome amigável do perfil.
GetNumPropIDS Obtém o número de IDs de propriedade em um perfil.
Getproperty Obtém o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação.
IsDefault Obtém um valor que indica se o perfil é o perfil de verificação padrão de um dispositivo IWiaItem2 associado.
RemoveProperty Remove uma lista especificada de propriedades filho no <Properties> elemento de um perfil de verificação.
Salvar Salva alterações em um perfil em disco.
Setitem Define o GUID da categoria do item WIA 2.0 ao qual o perfil está associado.
Setname Define o nome amigável do perfil.
Setproperty Define o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação.

 

Comentários

Qualquer dispositivo IWiaItem2 pode ter um perfil de verificação. No entanto, os itens IWiaItem2 dos tipos WIA_CATEGORY_FINISHED_FILE e WIA_CATEGORY_ROOT não podem ter perfis.

Se um perfil de verificação for salvo usando o método IScanProfile::Save , ele será armazenado como um arquivo XML em %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.

Para criar uma instância de um objeto IScanProfile , use o método IScanProfileMgr::CreateProfile . Para obter uma referência a um perfil de verificação que já foi salvo no disco, use o método IScanProfileMgr::OpenProfile .

Todos os perfis de verificação têm os seguintes elementos: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>e <Properties>. O perfil padrão de um dispositivo também tem um <Default> elemento.

O e <DeviceID> os <ProfileGUID> elementos não podem ser alterados depois que o perfil é criado. Os valores do <ProfileName> elemento e do <WiaItem> elemento podem ser alterados após a criação do perfil. O <Default> elemento pode ser adicionado ou excluído. Isso pode ser feito programaticamente com os métodos IScanProfile::SetName, IScanProfile::SetItem e IScanProfileMgr::SetDefault . Essas propriedades também podem ser alteradas pelos usuários por meio do método IScanProfileUI::ScanProfileDialog .

O <Properties> elemento contém <Property> filhos. Use-os para adicionar qualquer item ou propriedade do dispositivo WIA 2.0 ao perfil. Você também pode desenvolver seus próprios filhos de acquistão de <Property> imagem. Isso torna o Esquema de Perfil de Verificação extensível. (Para obter mais informações sobre como estender o esquema, consulte Definindo propriedades personalizadas, IScanProfile::GetProperty e IScanProfile::SetProperty.)

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
IDL
Scanprofiles.idl

Confira também

IDispatch

Esquema de perfil de verificação