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

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, itens IWiaItem2 de 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 em 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 .

Os <ProfileGUID> elementos e <DeviceID> não podem ser alterados após a criação do perfil. 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 de 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