Compartilhar via


Método IScanProfile::SetProperty

Define o valor das propriedades filho especificadas no <Properties> elemento de um perfil de verificação.

Sintaxe

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

Parâmetros

núm [in]

Tipo: ULONG

O número de entradas nas matrizes que são apontadas por pid e pvar.

pid [in]

Tipo: PROPID*

Um ponteiro para uma matriz de números de identificação das propriedades a serem definidas. Cada valor na matriz é uma constante de propriedade WIA.

pvar [in]

Tipo: PROPVARIANT*

Um ponteiro para uma matriz de valores a serem atribuídos às propriedades.

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Cada valor na matriz para a qual o pid aponta é uma das Constantes de Propriedade WIA. Você pode estender esse sistema de identificação. Consulte Definindo propriedades personalizadas.

As alterações em um perfil não são salvas no disco até que o aplicativo chame o método IScanProfile::Save .

Se dois aplicativos criarem objetos de perfil de verificação do mesmo arquivo XML e cada aplicativo gravar alterações em seu objeto, somente as alterações feitas pelo aplicativo que chama IScanProfile::Save last serão salvas no disco.

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]
Cabeçalho
Scanprofile.h
IDL
Scanprofiles.idl

Confira também

IScanProfile

Conceitual

Esquema de perfil de verificação

Constantes de propriedade WIA

Definindo propriedades personalizadas